diff --git a/doc/api/crypto.md b/doc/api/crypto.md index 07245e8cdc1075..5ae5c28851df07 100644 --- a/doc/api/crypto.md +++ b/doc/api/crypto.md @@ -1713,7 +1713,8 @@ console.log( `${buf.length} bytes of random data: ${buf.toString('hex')}`); ``` -The `crypto.randomBytes()` method will block until there is sufficient entropy. +The `crypto.randomBytes()` method will not complete until there is +sufficient entropy available. This should normally never take longer than a few milliseconds. The only time when generating the random bytes may conceivably block for a longer period of time is right after boot, when the whole system is still low on entropy.