// Copyright 2018-2022 the Deno authors. All rights reserved. MIT license. import { promisify } from "./internal/util.mjs"; import { callbackify } from "./_util/_util_callbackify.ts"; import { debuglog } from "./internal/util/debuglog.ts"; import { deprecate } from "./internal/util.mjs"; import { format, formatWithOptions, inspect, stripVTControlCharacters, } from "./internal/util/inspect.mjs"; import { codes } from "./internal/error_codes.ts"; import { errorMap } from "./internal_binding/uv.ts"; import types from "./util/types.ts"; import { Buffer } from "./buffer.ts"; import { isDeepStrictEqual } from "./internal/util/comparisons.ts"; export { callbackify, debuglog, deprecate, format, formatWithOptions, inspect, promisify, stripVTControlCharacters, types, }; const NumberIsSafeInteger = Number.isSafeInteger; /** @deprecated - use `Array.isArray()` instead. */ export function isArray(value: unknown): boolean { return Array.isArray(value); } /** @deprecated - use `typeof value === "boolean" || value instanceof Boolean` instead. */ export function isBoolean(value: unknown): boolean { return typeof value === "boolean" || value instanceof Boolean; } /** @deprecated - use `value === null` instead. */ export function isNull(value: unknown): boolean { return value === null; } /** @deprecated - use `value === null || value === undefined` instead. */ export function isNullOrUndefined(value: unknown): boolean { return value === null || value === undefined; } /** @deprecated - use `typeof value === "number" || value instanceof Number` instead. */ export function isNumber(value: unknown): boolean { return typeof value === "number" || value instanceof Number; } /** @deprecated - use `typeof value === "string" || value instanceof String` instead. */ export function isString(value: unknown): boolean { return typeof value === "string" || value instanceof String; } /** @deprecated - use `typeof value === "symbol"` instead. */ export function isSymbol(value: unknown): boolean { return typeof value === "symbol"; } /** @deprecated - use `value === undefined` instead. */ export function isUndefined(value: unknown): boolean { return value === undefined; } /** @deprecated - use `value !== null && typeof value === "object"` instead. */ export function isObject(value: unknown): boolean { return value !== null && typeof value === "object"; } /** @deprecated - use `e instanceof Error` instead. */ export function isError(e: unknown): boolean { return e instanceof Error; } /** @deprecated - use `typeof value === "function"` instead. */ export function isFunction(value: unknown): boolean { return typeof value === "function"; } /** @deprecated Use util.types.RegExp() instead. */ export function isRegExp(value: unknown): boolean { return types.isRegExp(value); } /** @deprecated Use util.types.isDate() instead. */ export function isDate(value: unknown): boolean { return types.isDate(value); } /** @deprecated - use `value === null || (typeof value !== "object" && typeof value !== "function")` instead. */ export function isPrimitive(value: unknown): boolean { return ( value === null || (typeof value !== "object" && typeof value !== "function") ); } /** @deprecated Use Buffer.isBuffer() instead. */ export function isBuffer(value: unknown): boolean { return Buffer.isBuffer(value); } /** @deprecated Use Object.assign() instead. */ export function _extend( target: Record, source: unknown, ): Record { // Don't do anything if source isn't an object if (source === null || typeof source !== "object") return target; const keys = Object.keys(source!); let i = keys.length; while (i--) { target[keys[i]] = (source as Record)[keys[i]]; } return target; } /** * 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]; } /** * https://nodejs.org/api/util.html#util_util_inherits_constructor_superconstructor * @param ctor Constructor function which needs to inherit the prototype. * @param superCtor Constructor function to inherit prototype from. */ export function inherits( ctor: new (...args: unknown[]) => T, superCtor: new (...args: unknown[]) => U, ) { if (ctor === undefined || ctor === null) { throw new codes.ERR_INVALID_ARG_TYPE("ctor", "Function", ctor); } if (superCtor === undefined || superCtor === null) { throw new codes.ERR_INVALID_ARG_TYPE("superCtor", "Function", superCtor); } if (superCtor.prototype === undefined) { throw new codes.ERR_INVALID_ARG_TYPE( "superCtor.prototype", "Object", superCtor.prototype, ); } Object.defineProperty(ctor, "super_", { value: superCtor, writable: true, configurable: true, }); Object.setPrototypeOf(ctor.prototype, superCtor.prototype); } import { _TextDecoder, _TextEncoder } from "./_utils.ts"; /** The global TextDecoder */ export type TextDecoder = import("./_utils.ts")._TextDecoder; export const TextDecoder = _TextDecoder; /** The global TextEncoder */ export type TextEncoder = import("./_utils.ts")._TextEncoder; export const TextEncoder = _TextEncoder; function pad(n: number) { return n.toString().padStart(2, "0"); } const months = [ "Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec", ]; /** * @returns 26 Feb 16:19:34 */ function timestamp(): string { const d = new Date(); const t = [ pad(d.getHours()), pad(d.getMinutes()), pad(d.getSeconds()), ].join(":"); return `${(d.getDate())} ${months[(d).getMonth()]} ${t}`; } /** * Log is just a thin wrapper to console.log that prepends a timestamp * @deprecated */ // deno-lint-ignore no-explicit-any function log(...args: any[]): void { console.log("%s - %s", timestamp(), format(...args)); } export default { format, formatWithOptions, inspect, isArray, isBoolean, isNull, isNullOrUndefined, isNumber, isString, isSymbol, isUndefined, isObject, isError, isFunction, isRegExp, isDate, isPrimitive, isBuffer, _extend, getSystemErrorName, deprecate, callbackify, promisify, inherits, types, stripVTControlCharacters, TextDecoder, TextEncoder, log, debuglog, isDeepStrictEqual, };