// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license. import { assert, assertEquals, assertStrictEquals, assertThrows, } from "@std/assert"; import { stripAnsiCode } from "@std/fmt/colors"; import * as util from "node:util"; import utilDefault from "node:util"; import { Buffer } from "node:buffer"; Deno.test({ name: "[util] format", fn() { assertEquals(util.format("%o", [10, 11]), "[ 10, 11, [length]: 2 ]"); }, }); Deno.test({ name: "[util] inspect.custom", fn() { assertEquals(util.inspect.custom, Symbol.for("nodejs.util.inspect.custom")); }, }); Deno.test({ name: "[util] inspect", fn() { assertEquals(stripAnsiCode(util.inspect({ foo: 123 })), "{ foo: 123 }"); assertEquals(stripAnsiCode(util.inspect("foo")), "'foo'"); assertEquals( stripAnsiCode(util.inspect("Deno's logo is so cute.")), `"Deno's logo is so cute."`, ); assertEquals( stripAnsiCode(util.inspect([1, 2, 3, 4, 5, 6, 7])), `[ 1, 2, 3, 4, 5, 6, 7 ]`, ); }, }); Deno.test({ name: "[util] isBoolean", fn() { assert(util.isBoolean(true)); assert(!util.isBoolean(new Boolean())); assert(!util.isBoolean(new Boolean(true))); assert(util.isBoolean(false)); assert(!util.isBoolean("deno")); assert(!util.isBoolean("true")); }, }); Deno.test({ name: "[util] isNull", fn() { let n; assert(util.isNull(null)); assert(!util.isNull(n)); assert(!util.isNull(0)); assert(!util.isNull({})); }, }); Deno.test({ name: "[util] isNullOrUndefined", fn() { let n; assert(util.isNullOrUndefined(null)); assert(util.isNullOrUndefined(n)); assert(!util.isNullOrUndefined({})); assert(!util.isNullOrUndefined("undefined")); }, }); Deno.test({ name: "[util] isNumber", fn() { assert(util.isNumber(666)); assert(!util.isNumber(new Number(666))); assert(!util.isNumber("999")); assert(!util.isNumber(null)); }, }); Deno.test({ name: "[util] isString", fn() { assert(util.isString("deno")); assert(!util.isString(new String("DIO"))); assert(!util.isString(1337)); }, }); Deno.test({ name: "[util] isSymbol", fn() { assert(util.isSymbol(Symbol())); assert(!util.isSymbol(Object(Symbol()))); assert(!util.isSymbol(123)); assert(!util.isSymbol("string")); }, }); Deno.test({ name: "[util] isUndefined", fn() { let t; assert(util.isUndefined(t)); assert(!util.isUndefined("undefined")); assert(!util.isUndefined({})); }, }); Deno.test({ name: "[util] isObject", fn() { const dio = { stand: "Za Warudo" }; assert(util.isObject(dio)); assert(util.isObject(new RegExp(/Toki Wo Tomare/))); assert(!util.isObject("Jotaro")); }, }); Deno.test({ name: "[util] isError", fn() { const java = new Error(); const nodejs = Reflect.construct(Error, [], Object); const bun = new DOMException(); const deno = "Future"; assert(util.isError(java)); assert(util.isError(nodejs)); assert(util.isError(bun)); assert(!util.isError(deno)); }, }); Deno.test({ name: "[util] isFunction", fn() { const f = function () {}; assert(util.isFunction(f)); assert(!util.isFunction({})); assert(!util.isFunction(new RegExp(/f/))); }, }); Deno.test({ name: "[util] isRegExp", fn() { assert(util.isRegExp(new RegExp(/f/))); assert(util.isRegExp(/fuManchu/)); assert(!util.isRegExp({ evil: "eye" })); assert(!util.isRegExp(null)); }, }); Deno.test({ name: "[util] isArray", fn() { assert(util.isArray([])); assert(!util.isArray({ yaNo: "array" })); assert(!util.isArray(null)); }, }); Deno.test({ name: "[util] isPrimitive", fn() { const stringType = "hasti"; const booleanType = true; const integerType = 2; const symbolType = Symbol("anything"); const functionType = function doBest() {}; const objectType = { name: "ali" }; const arrayType = [1, 2, 3]; assert(util.isPrimitive(stringType)); assert(util.isPrimitive(booleanType)); assert(util.isPrimitive(integerType)); assert(util.isPrimitive(symbolType)); assert(util.isPrimitive(null)); assert(util.isPrimitive(undefined)); assert(!util.isPrimitive(functionType)); assert(!util.isPrimitive(arrayType)); assert(!util.isPrimitive(objectType)); }, }); Deno.test({ name: "[util] isDate", fn() { // Test verifies the method is exposed. See _util/_util_types_test for details assert(util.isDate(new Date())); }, }); Deno.test({ name: "[util] isBuffer", fn() { assert(util.isBuffer(new Buffer(4))); assert(!util.isBuffer(new Uint8Array(4))); }, }); Deno.test({ name: "[util] types.isTypedArray", fn() { assert(util.types.isTypedArray(new Buffer(4))); assert(util.types.isTypedArray(new Uint8Array(4))); assert(!util.types.isTypedArray(new DataView(new ArrayBuffer(4)))); }, }); Deno.test({ name: "[util] types.isNativeError", fn() { assert(util.types.isNativeError(new Error())); assert(util.types.isNativeError(new TypeError())); assert(!util.types.isNativeError(new DOMException())); }, }); Deno.test({ name: "[util] TextDecoder", fn() { assert(util.TextDecoder === TextDecoder); const td: util.TextDecoder = new util.TextDecoder(); assert(td instanceof TextDecoder); }, }); Deno.test({ name: "[util] TextEncoder", fn() { assert(util.TextEncoder === TextEncoder); const te: util.TextEncoder = new util.TextEncoder(); assert(te instanceof TextEncoder); }, }); Deno.test({ name: "[util] toUSVString", fn() { assertEquals(util.toUSVString("foo"), "foo"); assertEquals(util.toUSVString("bar\ud801"), "bar\ufffd"); }, }); Deno.test({ name: "[util] getSystemErrorName()", fn() { type FnTestInvalidArg = (code?: unknown) => void; assertThrows( () => (util.getSystemErrorName as FnTestInvalidArg)(), TypeError, ); assertThrows( () => (util.getSystemErrorName as FnTestInvalidArg)(1), RangeError, ); assertStrictEquals(util.getSystemErrorName(-424242), undefined); switch (Deno.build.os) { case "windows": assertStrictEquals(util.getSystemErrorName(-4091), "EADDRINUSE"); break; case "darwin": assertStrictEquals(util.getSystemErrorName(-48), "EADDRINUSE"); break; case "linux": assertStrictEquals(util.getSystemErrorName(-98), "EADDRINUSE"); break; } }, }); Deno.test({ name: "[util] deprecate() works", fn() { const fn = util.deprecate(() => {}, "foo"); fn(); }, }); Deno.test({ name: "[util] callbackify() works", fn() { const fn = util.callbackify(() => Promise.resolve("foo")); fn((err, value) => { assert(err === null); assert(value === "foo"); }); }, }); Deno.test({ name: "[util] callbackify(undefined) throws", fn() { assertThrows( // @ts-expect-error: testing runtime error () => util.callbackify(undefined), TypeError, 'The "original" argument must be of type function', ); }, }); Deno.test({ name: "[util] parseArgs() with no args works", fn() { util.parseArgs({}); }, }); Deno.test("[util] debuglog() and debug()", () => { assert(typeof util.debug === "function"); assert(typeof util.debuglog === "function"); assertEquals(util.debuglog, util.debug); assertEquals(utilDefault.debuglog, utilDefault.debug); }); Deno.test("[util] aborted()", async () => { const abortController = new AbortController(); let done = false; const promise = util.aborted( // deno-lint-ignore no-explicit-any abortController.signal as any, abortController.signal, ); promise.then(() => { done = true; }); await new Promise((r) => setTimeout(r, 100)); assertEquals(done, false); abortController.abort(); await promise; assertEquals(done, true); }); Deno.test("[util] styleText()", () => { const redText = util.styleText("red", "error"); assertEquals(redText, "\x1B[31merror\x1B[39m"); }); Deno.test("[util] styleText() with array of formats", () => { const colored = util.styleText(["red", "green"], "error"); assertEquals(colored, "\x1b[32m\x1b[31merror\x1b[39m\x1b[39m"); });