mirror of
https://github.com/denoland/deno.git
synced 2024-12-12 10:37:52 -05:00
ce75e31625
This commit changes "include_js_files!" macro from "deno_core" in a way that "dir" option doesn't cause specifiers to be rewritten to include it. Example: ``` include_js_files! { dir "js", "hello.js", } ``` The above definition required embedders to use: `import ... from "internal:<ext_name>/js/hello.js"`. But with this change, the "js" directory in which the files are stored is an implementation detail, which for embedders results in: `import ... from "internal:<ext_name>/hello.js"`. The directory the files are stored in, is an implementation detail and in some cases might result in a significant size difference for the snapshot. As an example, in "deno_node" extension, we store the source code in "polyfills" directory; which resulted in each specifier to look like "internal:deno_node/polyfills/<module_name>", but with this change it's "internal:deno_node/<module_name>". Given that "deno_node" has over 100 files, many of them having several import specifiers to the same extension, this change removes 10 characters from each import specifier.
210 lines
5.9 KiB
TypeScript
210 lines
5.9 KiB
TypeScript
// Copyright 2018-2023 the Deno authors. All rights reserved. MIT license.
|
|
|
|
import {
|
|
TextDecoder,
|
|
TextEncoder,
|
|
} from "internal:deno_web/08_text_encoding.js";
|
|
import { errorMap } from "internal:deno_node/internal_binding/uv.ts";
|
|
import { codes } from "internal: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];
|
|
}
|