mirror of
https://github.com/denoland/deno.git
synced 2024-10-29 08:58:01 -04:00
210 lines
6 KiB
TypeScript
210 lines
6 KiB
TypeScript
// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
|
|
|
|
// TODO(petamoriken): enable prefer-primordials for node polyfills
|
|
// deno-lint-ignore-file prefer-primordials
|
|
|
|
import { TextDecoder, TextEncoder } from "ext:deno_web/08_text_encoding.js";
|
|
import { errorMap } from "ext:deno_node/internal_binding/uv.ts";
|
|
import { codes } from "ext:deno_node/internal/error_codes.ts";
|
|
|
|
export type BinaryEncodings = "binary";
|
|
|
|
export type TextEncodings =
|
|
| "ascii"
|
|
| "utf8"
|
|
| "utf-8"
|
|
| "utf16le"
|
|
| "ucs2"
|
|
| "ucs-2"
|
|
| "base64"
|
|
| "latin1"
|
|
| "hex";
|
|
|
|
export type Encodings = BinaryEncodings | TextEncodings;
|
|
|
|
export function notImplemented(msg: string): never {
|
|
const message = msg ? `Not implemented: ${msg}` : "Not implemented";
|
|
throw new Error(message);
|
|
}
|
|
|
|
export function warnNotImplemented(msg?: string) {
|
|
const message = msg
|
|
? `Warning: Not implemented: ${msg}`
|
|
: "Warning: Not implemented";
|
|
console.warn(message);
|
|
}
|
|
|
|
export type _TextDecoder = typeof TextDecoder.prototype;
|
|
export const _TextDecoder = TextDecoder;
|
|
|
|
export type _TextEncoder = typeof TextEncoder.prototype;
|
|
export const _TextEncoder = TextEncoder;
|
|
|
|
// API helpers
|
|
|
|
export type MaybeNull<T> = T | null;
|
|
export type MaybeDefined<T> = T | undefined;
|
|
export type MaybeEmpty<T> = T | null | undefined;
|
|
|
|
export function intoCallbackAPI<T>(
|
|
// deno-lint-ignore no-explicit-any
|
|
func: (...args: any[]) => Promise<T>,
|
|
cb: MaybeEmpty<(err: MaybeNull<Error>, value?: MaybeEmpty<T>) => void>,
|
|
// deno-lint-ignore no-explicit-any
|
|
...args: any[]
|
|
) {
|
|
func(...args).then(
|
|
(value) => cb && cb(null, value),
|
|
(err) => cb && cb(err),
|
|
);
|
|
}
|
|
|
|
export function intoCallbackAPIWithIntercept<T1, T2>(
|
|
// deno-lint-ignore no-explicit-any
|
|
func: (...args: any[]) => Promise<T1>,
|
|
interceptor: (v: T1) => T2,
|
|
cb: MaybeEmpty<(err: MaybeNull<Error>, value?: MaybeEmpty<T2>) => void>,
|
|
// deno-lint-ignore no-explicit-any
|
|
...args: any[]
|
|
) {
|
|
func(...args).then(
|
|
(value) => cb && cb(null, interceptor(value)),
|
|
(err) => cb && cb(err),
|
|
);
|
|
}
|
|
|
|
export function spliceOne(list: string[], index: number) {
|
|
for (; index + 1 < list.length; index++) list[index] = list[index + 1];
|
|
list.pop();
|
|
}
|
|
|
|
// Taken from: https://github.com/nodejs/node/blob/ba684805b6c0eded76e5cd89ee00328ac7a59365/lib/internal/util.js#L125
|
|
// Return undefined if there is no match.
|
|
// Move the "slow cases" to a separate function to make sure this function gets
|
|
// inlined properly. That prioritizes the common case.
|
|
export function normalizeEncoding(
|
|
enc: string | null,
|
|
): TextEncodings | undefined {
|
|
if (enc == null || enc === "utf8" || enc === "utf-8") return "utf8";
|
|
return slowCases(enc);
|
|
}
|
|
|
|
// https://github.com/nodejs/node/blob/ba684805b6c0eded76e5cd89ee00328ac7a59365/lib/internal/util.js#L130
|
|
function slowCases(enc: string): TextEncodings | undefined {
|
|
switch (enc.length) {
|
|
case 4:
|
|
if (enc === "UTF8") return "utf8";
|
|
if (enc === "ucs2" || enc === "UCS2") return "utf16le";
|
|
enc = `${enc}`.toLowerCase();
|
|
if (enc === "utf8") return "utf8";
|
|
if (enc === "ucs2") return "utf16le";
|
|
break;
|
|
case 3:
|
|
if (enc === "hex" || enc === "HEX" || `${enc}`.toLowerCase() === "hex") {
|
|
return "hex";
|
|
}
|
|
break;
|
|
case 5:
|
|
if (enc === "ascii") return "ascii";
|
|
if (enc === "ucs-2") return "utf16le";
|
|
if (enc === "UTF-8") return "utf8";
|
|
if (enc === "ASCII") return "ascii";
|
|
if (enc === "UCS-2") return "utf16le";
|
|
enc = `${enc}`.toLowerCase();
|
|
if (enc === "utf-8") return "utf8";
|
|
if (enc === "ascii") return "ascii";
|
|
if (enc === "ucs-2") return "utf16le";
|
|
break;
|
|
case 6:
|
|
if (enc === "base64") return "base64";
|
|
if (enc === "latin1" || enc === "binary") return "latin1";
|
|
if (enc === "BASE64") return "base64";
|
|
if (enc === "LATIN1" || enc === "BINARY") return "latin1";
|
|
enc = `${enc}`.toLowerCase();
|
|
if (enc === "base64") return "base64";
|
|
if (enc === "latin1" || enc === "binary") return "latin1";
|
|
break;
|
|
case 7:
|
|
if (
|
|
enc === "utf16le" ||
|
|
enc === "UTF16LE" ||
|
|
`${enc}`.toLowerCase() === "utf16le"
|
|
) {
|
|
return "utf16le";
|
|
}
|
|
break;
|
|
case 8:
|
|
if (
|
|
enc === "utf-16le" ||
|
|
enc === "UTF-16LE" ||
|
|
`${enc}`.toLowerCase() === "utf-16le"
|
|
) {
|
|
return "utf16le";
|
|
}
|
|
break;
|
|
default:
|
|
if (enc === "") return "utf8";
|
|
}
|
|
}
|
|
|
|
export function validateIntegerRange(
|
|
value: number,
|
|
name: string,
|
|
min = -2147483648,
|
|
max = 2147483647,
|
|
) {
|
|
// The defaults for min and max correspond to the limits of 32-bit integers.
|
|
if (!Number.isInteger(value)) {
|
|
throw new Error(`${name} must be 'an integer' but was ${value}`);
|
|
}
|
|
|
|
if (value < min || value > max) {
|
|
throw new Error(
|
|
`${name} must be >= ${min} && <= ${max}. Value was ${value}`,
|
|
);
|
|
}
|
|
}
|
|
|
|
type OptionalSpread<T> = T extends undefined ? []
|
|
: [T];
|
|
|
|
export function once<T = undefined>(
|
|
callback: (...args: OptionalSpread<T>) => void,
|
|
) {
|
|
let called = false;
|
|
return function (this: unknown, ...args: OptionalSpread<T>) {
|
|
if (called) return;
|
|
called = true;
|
|
callback.apply(this, args);
|
|
};
|
|
}
|
|
|
|
export function makeMethodsEnumerable(klass: { new (): unknown }) {
|
|
const proto = klass.prototype;
|
|
for (const key of Object.getOwnPropertyNames(proto)) {
|
|
const value = proto[key];
|
|
if (typeof value === "function") {
|
|
const desc = Reflect.getOwnPropertyDescriptor(proto, key);
|
|
if (desc) {
|
|
desc.enumerable = true;
|
|
Object.defineProperty(proto, key, desc);
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
const NumberIsSafeInteger = Number.isSafeInteger;
|
|
|
|
/**
|
|
* Returns a system error name from an error code number.
|
|
* @param code error code number
|
|
*/
|
|
export function getSystemErrorName(code: number): string | undefined {
|
|
if (typeof code !== "number") {
|
|
throw new codes.ERR_INVALID_ARG_TYPE("err", "number", code);
|
|
}
|
|
if (code >= 0 || !NumberIsSafeInteger(code)) {
|
|
throw new codes.ERR_OUT_OF_RANGE("err", "a negative integer", code);
|
|
}
|
|
return errorMap.get(code)?.[0];
|
|
}
|