← Cloudflare Workers / workers / runtime-apis / nodejs

util

promisify/callbackify

promisify a callbackify API v Node.js poskytují způsob, jak propojit programovací model založený na Promise s modelem založeným na callbacích.

promisify metoda umožňuje vzít callback funkci ve stylu Node.js a převést ji na asynchronní funkci vracející Promise:

import { promisify } from "node:util";

function foo(args, callback) {
	try {
		callback(null, 1);
	} catch (err) {
		// Errors are emitted to the callback via the first argument.
		callback(err);
	}
}

const promisifiedFoo = promisify(foo);
await promisifiedFoo(args);

Podobně jako promisify, callbackify převádí asynchronní funkci vracející Promise na funkci se zpětným voláním ve stylu Node.js:

import { callbackify } from 'node:util';

async function foo(args) {
  throw new Error('boom');
}

const callbackifiedFoo = callbackify(foo);

callbackifiedFoo(args, (err, value) => {
  if (err) throw err;
});

callbackify a promisify usnadňují řešení všech problémů spojených s propojováním callbacků a promises.

Viz Dokumentace Node.js pro callbackify ↗ a Dokumentace Node.js pro promisify ↗ s dalšími informacemi.

util.types

util.types API poskytuje spolehlivý a efektivní způsob, jak ověřit, že hodnoty jsou instancemi různých vestavěných typů.

import { types } from "node:util";

types.isAnyArrayBuffer(new ArrayBuffer()); // Returns true
types.isAnyArrayBuffer(new SharedArrayBuffer()); // Returns true
types.isArrayBufferView(new Int8Array()); // true
types.isArrayBufferView(Buffer.from("hello world")); // true
types.isArrayBufferView(new DataView(new ArrayBuffer(16))); // true
types.isArrayBufferView(new ArrayBuffer()); // false
function foo() {
	types.isArgumentsObject(arguments); // Returns true
}
types.isAsyncFunction(function foo() {}); // Returns false
types.isAsyncFunction(async function foo() {}); // Returns true
// .. and so on

Více informací o util.types, viz Dokumentace Node.js pro util.types ↗.

util.MIMEType

util.MIMEType poskytuje pomocné metody, které usnadňují práci a manipulaci s Typy MIME ↗. Například:

import { MIMEType } from "node:util";

const myMIME = new MIMEType("text/javascript;key=value");

console.log(myMIME.type);
// Prints: text

console.log(myMIME.essence);
// Prints: text/javascript

console.log(myMIME.subtype);
// Prints: javascript

console.log(String(myMIME));
// Prints: application/javascript;key=value

Více informací o util.MIMEType, viz Dokumentace Node.js pro util.MIMEType ↗.