nodejs
diff --git a/Collapse file
‎doc/api/util.md‎
Copy file name to clipboardExpand all lines: doc/api/util.md
+21Lines changed: 21 additions & 0 deletions
Display the source diff
Display the rich diff b/Collapse file
‎doc/api/util.md‎
Copy file name to clipboardExpand all lines: doc/api/util.md
+21Lines changed: 21 additions & 0 deletions
Display the source diff
Display the rich diff
diff --git a/Collapse file
‎lib/internal/util.js‎
Copy file name to clipboardExpand all lines: lib/internal/util.js
+1-1Lines changed: 1 addition & 1 deletion b/Collapse file
‎lib/internal/util.js‎
Copy file name to clipboardExpand all lines: lib/internal/util.js
+1-1Lines changed: 1 addition & 1 deletion
diff --git a/Collapse file
‎test/parallel/test-util-promisify.js‎
Copy file name to clipboardExpand all lines: test/parallel/test-util-promisify.js
+15Lines changed: 15 additions & 0 deletions b/Collapse file
‎test/parallel/test-util-promisify.js‎
Copy file name to clipboardExpand all lines: test/parallel/test-util-promisify.js
+15Lines changed: 15 additions & 0 deletions
@@ -995,11 +995,32 @@ throw an error.
 ### `util.promisify.custom`
 <!-- YAML
 added: v8.0.0
+changes:
+  - version: REPLACEME
+    pr-url: https://github.com/nodejs/node/pull/31672
+    description: This is now defined as a shared symbol.
 -->
 
 * {symbol} that can be used to declare custom promisified variants of functions,
 see [Custom promisified functions][].
 
+In addition to being accessible through `util.promisify.custom`, this
+symbol is [registered globally][global symbol registry] and can be
+accessed in any environment as `Symbol.for('nodejs.util.promisify.custom')`.
+
+For example, with a function that takes in
+`(foo, onSuccessCallback, onErrorCallback)`:
+
+```js
+const kCustomPromisifiedSymbol = Symbol.for('nodejs.util.promisify.custom');
+
+doSomething[kCustomPromisifiedSymbol] = (foo) => {
+  return new Promise((resolve, reject) => {
+    doSomething(foo, resolve, reject);
+  });
+};
+```
+
 ## Class: `util.TextDecoder`
 <!-- YAML
 added: v8.3.0
 
@@ -271,7 +271,7 @@ function getSystemErrorName(err) {
   return entry ? entry[0] : `Unknown system error ${err}`;
 }
 
-const kCustomPromisifiedSymbol = Symbol('util.promisify.custom');
+const kCustomPromisifiedSymbol = SymbolFor('nodejs.util.promisify.custom');
 const kCustomPromisifyArgsSymbol = Symbol('customPromisifyArgs');
 
 function promisify(original) {
 
@@ -33,6 +33,21 @@ const stat = promisify(fs.stat);
   assert.strictEqual(promisify(promisify(fn)), promisifedFn);
 }
 
+{
+  function fn() {}
+
+  function promisifiedFn() {}
+
+  // util.promisify.custom is a shared symbol which can be accessed
+  // as `Symbol.for("nodejs.util.promisify.custom")`.
+  const kCustomPromisifiedSymbol = Symbol.for('nodejs.util.promisify.custom');
+  fn[kCustomPromisifiedSymbol] = promisifiedFn;
+
+  assert.strictEqual(kCustomPromisifiedSymbol, promisify.custom);
+  assert.strictEqual(promisify(fn), promisifiedFn);
+  assert.strictEqual(promisify(promisify(fn)), promisifiedFn);
+}
+
 {
   function fn() {}
   fn[promisify.custom] = 42;
Original file line number	Diff line number	Diff line change
`@@ -271,7 +271,7 @@ function getSystemErrorName(err) {`
`271`	`271`	return entry ? entry[0] : `Unknown system error ${err}`;
`272`	`272`	`}`
`273`	`273`
`274`		`-const kCustomPromisifiedSymbol = Symbol('util.promisify.custom');`
	`274`	`+const kCustomPromisifiedSymbol = SymbolFor('nodejs.util.promisify.custom');`
`275`	`275`	`const kCustomPromisifyArgsSymbol = Symbol('customPromisifyArgs');`
`276`	`276`
`277`	`277`	`function promisify(original) {`