crypto: deprecate aliases for randomBytes

PR-URL: https://github.com/nodejs/node/pull/22519
Reviewed-By: Michaël Zasso <targos@protonmail.com>
Reviewed-By: Ujjwal Sharma <usharma1998@gmail.com>
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
Reviewed-By: Matteo Collina <matteo.collina@gmail.com>
Reviewed-By: Trivikram Kamat <trivikr.dev@gmail.com>
Reviewed-By: Sakthipriyan Vairamani <thechargingvolcano@gmail.com>
Reviewed-By: James M Snell <jasnell@gmail.com>

1 files changed, 17 insertions, 3 deletions

diff --git a/lib/crypto.js b/lib/crypto.js
index c2d3eb38cf..ecf0c4d10b 100644
--- a/lib/crypto.js
+++ b/lib/crypto.js
@@ -155,14 +155,11 @@ module.exports = exports = {
   pbkdf2Sync,
   privateDecrypt,
   privateEncrypt,
-  prng: randomBytes,
-  pseudoRandomBytes: randomBytes,
   publicDecrypt,
   publicEncrypt,
   randomBytes,
   randomFill,
   randomFillSync,
-  rng: randomBytes,
   scrypt,
   scryptSync,
   setEngine,
@@ -234,5 +231,22 @@ Object.defineProperties(exports, {
     configurable: false,
     enumerable: true,
     value: constants
+  },
+
+  // Aliases for randomBytes are deprecated.
+  // The ecosystem needs those to exist for backwards compatibility with
+  // ancient Node.js runtimes (0.10, 0.12).
+  prng: {
+    enumerable: false,
+    value: deprecate(randomBytes, 'crypto.prng is deprecated.', 'DEP0115')
+  },
+  pseudoRandomBytes: {
+    enumerable: false,
+    value: deprecate(randomBytes,
+                     'crypto.pseudoRandomBytes is deprecated.', 'DEP0115')
+  },
+  rng: {
+    enumerable: false,
+    value: deprecate(randomBytes, 'crypto.rng is deprecated.', 'DEP0115')
   }
 });