diff --git a/doc/api/crypto.md b/doc/api/crypto.md index a40178db22..79c7a3c733 100644 --- a/doc/api/crypto.md +++ b/doc/api/crypto.md @@ -1540,7 +1540,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.