typings: add types for internalBinding('util')

PR-URL: https://github.com/nodejs/node/pull/38200
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Bradley Farias <bradley.meck@gmail.com>

1 files changed, 47 insertions, 0 deletions

diff --git a/typings/internalBinding/util.d.ts b/typings/internalBinding/util.d.ts
new file mode 100644
index 00000000000..2158c7ed688
--- /dev/null
+++ b/typings/internalBinding/util.d.ts
@@ -0,0 +1,47 @@
+declare namespace InternalUtilBinding {
+  class WeakReference<T extends object> {
+    constructor(value: T);
+    get(): undefined | T;
+    incRef(): void;
+    decRef(): void;
+  }
+}
+
+declare function InternalBinding(binding: 'util'): {
+  // PER_ISOLATE_PRIVATE_SYMBOL_PROPERTIES, defined in src/env.h
+  alpn_buffer_private_symbol: 0;
+  arrow_message_private_symbol: 1;
+  contextify_context_private_symbol: 2;
+  contextify_global_private_symbol: 3;
+  decorated_private_symbol: 4;
+  napi_type_tag: 5;
+  napi_wrapper: 6;
+  untransferable_object_private_symbol: 7;
+
+  kPending: 0;
+  kFulfilled: 1;
+  kRejected: 2;
+
+  getHiddenValue(object: object, index: number): any;
+  setHiddenValue(object: object, index: number, value: any): boolean;
+  getPromiseDetails(promise: any): undefined | [state: 0] | [state: 1 | 2, result: any];
+  getProxyDetails(proxy: any, fullProxy?: boolean): undefined | any | [target: any, handler: any];
+  previewEntries(object: object, slowPath?: boolean): undefined | any[] | [entries: any[], isKeyValue: boolean];
+  getOwnNonIndexProperties(object: object, filter: number): Array<string | symbol>;
+  getConstructorName(object: object): string;
+  getExternalValue(value: any): bigint;
+  sleep(msec: number): void;
+  isConstructor(fn: Function): boolean;
+  arrayBufferViewHasBuffer(view: ArrayBufferView): boolean;
+  propertyFilter: {
+    ALL_PROPERTIES: 0;
+    ONLY_WRITABLE: 1;
+    ONLY_ENUMERABLE: 2;
+    ONLY_CONFIGURABLE: 4;
+    SKIP_STRINGS: 8;
+    SKIP_SYMBOLS: 16;
+  };
+  shouldAbortOnUncaughtToggle: [shouldAbort: 0 | 1];
+  WeakReference: typeof InternalUtilBinding.WeakReference;
+  guessHandleType(fd: number): 'TCP' | 'TTY' | 'UDP' | 'FILE' | 'PIPE' | 'UNKNOWN';
+};