Skip to content
Browse files

docs: document crypto.randomBytes()

  • Loading branch information...
1 parent 413d38c commit abfcd1fb00a386c846b77b026e30f0f140a3c2a6 @bnoordhuis committed Sep 22, 2011
Showing with 18 additions and 0 deletions.
  1. +18 −0 doc/api/crypto.markdown
View
18 doc/api/crypto.markdown
@@ -238,3 +238,21 @@ Sets the Diffie-Hellman private key. Key encoding can be `'binary'`, `'hex'`, or
Asynchronous PBKDF2 applies pseudorandom function HMAC-SHA1 to derive
a key of given length from the given password, salt and iterations.
The callback gets two arguments `(err, derivedKey)`.
+
+### randomBytes(size, [callback])
+
+Generates cryptographically strong pseudo-random data. Usage:
+
+ // async
+ crypto.randomBytes(256, function(ex, buf) {
+ if (ex) throw ex;
+ console.log('Have %d bytes of random data: %s', buf.length, buf);
+ });
+
+ // sync
+ try {
+ var buf = crypto.randomBytes(256);
+ console.log('Have %d bytes of random data: %s', buf.length, buf);
+ } catch (ex) {
+ // handle error
+ }

0 comments on commit abfcd1f

Please sign in to comment.
Something went wrong with that request. Please try again.