ext/node/polyfills/internal_binding/util.ts - main - githubmirror/deno

ext/node/polyfills/internal_binding/util.ts
143 строки4 KB
refactor(ext/node): use primordials across the node:* polyfill layer (#34721)
03 июн 2026, 17:24
03 июн 2026, 17:249935b92
// Copyright 2018-2026 the Deno authors. MIT license.
// Copyright Joyent, Inc. and other Node contributors.
//
// Permission is hereby granted, free of charge, to any person obtaining a
// copy of this software and associated documentation files (the
// "Software"), to deal in the Software without restriction, including
// without limitation the rights to use, copy, modify, merge, publish,
// distribute, sublicense, and/or sell copies of the Software, and to permit
// persons to whom the Software is furnished to do so, subject to the
// following conditions:
//
// The above copyright notice and this permission notice shall be included
// in all copies or substantial portions of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
// OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN
// NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
// DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
// OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
// USE OR OTHER DEALINGS IN THE SOFTWARE.

// This module ports:
// - https://github.com/nodejs/node/blob/master/src/util-inl.h
// - https://github.com/nodejs/node/blob/master/src/util.cc
// - https://github.com/nodejs/node/blob/master/src/util.h

(function () {
const { core, primordials } = __bootstrap;
const {
  op_node_get_own_non_index_properties,
  op_node_guess_handle_type,
  op_node_parse_env,
  op_node_view_has_buffer,
} = core.ops;
const {
  StringPrototypeCharCodeAt,
  SymbolFor,
} = primordials;

const handleTypes = ["TCP", "TTY", "UDP", "FILE", "PIPE", "UNKNOWN"];
function guessHandleType(fd: number): string {
  const type = op_node_guess_handle_type(fd);
  return handleTypes[type];
}

const ALL_PROPERTIES = 0;
const ONLY_WRITABLE = 1;
const ONLY_ENUMERABLE = 2;
const ONLY_CONFIGURABLE = 4;
const ONLY_ENUM_WRITABLE = 6;
const SKIP_STRINGS = 8;
const SKIP_SYMBOLS = 16;

/**
 * Efficiently determine whether the provided property key is numeric
 * (and thus could be an array indexer) or not.
 *
 * Always returns true for values of type `'number'`.
 *
 * Otherwise, only returns true for strings that consist only of positive integers.
 *
 * Results are cached.
 */
const isNumericLookup: Record<string, boolean> = {};
function isArrayIndex(value: unknown): value is number | string {
  switch (typeof value) {
    case "number":
      return value >= 0 && (value | 0) === value;
    case "string": {
      const result = isNumericLookup[value];
      if (result !== void 0) {
        return result;
      }
      const length = value.length;
      if (length === 0) {
        return isNumericLookup[value] = false;
      }
      let ch = 0;
      let i = 0;
      for (; i < length; ++i) {
        ch = StringPrototypeCharCodeAt(value, i);
        if (
          i === 0 && ch === 0x30 && length > 1 /* must not start with 0 */ ||
          ch < 0x30 /* 0 */ || ch > 0x39 /* 9 */
        ) {
          return isNumericLookup[value] = false;
        }
      }
      return isNumericLookup[value] = true;
    }
    default:
      return false;
  }
}

function getOwnNonIndexProperties(
  obj: object,
  filter: number,
): (string | symbol)[] {
  return op_node_get_own_non_index_properties(obj, filter);
}

function arrayBufferViewHasBuffer(
  view: ArrayBufferView,
): boolean {
  return op_node_view_has_buffer(view);
}

const parseEnv = op_node_parse_env as (
  env: string,
) => Record<string, string>;

const untransferableSymbol = SymbolFor(
  "nodejs.worker_threads.untransferable",
);

const _defaultExport = {
  guessHandleType,
  isArrayIndex,
  getOwnNonIndexProperties,
  arrayBufferViewHasBuffer,
  parseEnv,
  untransferableSymbol,
};

return {
  guessHandleType,
  isArrayIndex,
  getOwnNonIndexProperties,
  arrayBufferViewHasBuffer,
  ALL_PROPERTIES,
  ONLY_WRITABLE,
  ONLY_ENUMERABLE,
  ONLY_CONFIGURABLE,
  ONLY_ENUM_WRITABLE,
  SKIP_STRINGS,
  SKIP_SYMBOLS,
  parseEnv,
  untransferableSymbol,
  default: _defaultExport,
};
})();