Node.js Util 模組中的一些有用函數

Node.js 包含一系列元件，這些元件組合在一起形成 JavaScript 執行環境。在 Node.js 架構 - Node.js 簡介系列中，我們探索了構成 Node.js 的各種元件及其各自的功能。

在 Node.js 中，有許多內建模組 - 即從一開始就整合的模組。 util 就是這樣的一個模組，在我看來，它值得更多的關注。 util 模組包含一系列小實用函數，這些函數在某些情況下很有用。在本文中，我們將深入研究其中一些功能...

util.promisify 和 util.callbackify

回呼是處理非同步程式碼的最早的方法之一。然而，回調有幾個限制，例如創建嵌套代碼並導致臭名昭著的“回調地獄”。有時，閱讀一段以回調風格編寫的程式碼可能會讓人不知所措。新增功能可能具有挑戰性，因為它需要引入額外的邏輯層。

在 Node.js 中，有一個實用函數可以將使用回呼風格的非同步函數轉換為 Promises。當你想要過渡到基於 Promise 的方法，然後將其與 async/await 結合起來，使你的程式碼更簡潔、更易於理解時，此函數非常有用。

const util = require('node:util');
const fs = require('node:fs');

const stat = util.promisify(fs.stat);

async function callStat() {
  const stats = await stat('.');
  console.log(`This directory is owned by ${stats.uid}`);
}

callStat(); 

相反，我們有 util.callbackify 將基於 Promise 的函數轉換回回調。

const util = require('node:util');

async function fn() {
  return 'hello world';
}
const callbackFunction = util.callbackify(fn);

callbackFunction((err, ret) => {
  if (err) throw err;
  console.log(ret);
}); 

util.棄用

如果您經常使用函式庫，您可能已經注意到控制台訊息表明某個函數已被棄用。

oldFunction() is deprecated. Use newFunction() instead.

這是一條通知，表示 oldFunction 的支援生命週期已接近尾聲，將來可能會被刪除。這是提醒開發人員某個函數即將「退休」並使用替代函數的常見方法。

在 Node.js 中，如果您需要警告其他人某個函數即將終止，有一個簡單的方法可以顯示此通知。

const util = require('util');

function oldFunction() {
    console.log('This function is deprecated!');
}

const deprecatedFunction = util.deprecate(oldFunction, 'oldFunction() is deprecated. Use newFunction() instead.');

只需將 oldFunction 「包裝」在 util.deprecate 中即可。每次呼叫 oldFunction 時，控制台中都會出現警告訊息。

實用程式類型

從 ES6 開始，我們有額外的函數來檢查資料類型：布林、陣列、物件等

util 模組有一個 types 屬性，可以擴充檢查資料類型的功能。

例如：

console.log(util.types.isPromise(Promise.resolve())); // true
console.log(util.types.isRegExp(/abc/)); // true
console.log(util.types.isDate(new Date())); // true

完整列表可在 util.types | 取得。 Node.js 文件。

util.isDeepStrictEqual

isDeepStrictEqual 是比較兩個物件並確定它們是否相同的最有效方法。

const util = require('util');

const obj1 = { a: 1, b: { c: 2 } };
const obj2 = { a: 1, b: { c: 2 } };

console.log(util.isDeepStrictEqual(obj1, obj2)); // true

除了這些函數之外，util 模組還提供了許多其他實用函數，例如 util.styleText 用於格式化控制台中的文字輸出，以及 util.parseEnv 用於解析 .env 檔案中的環境變數內容。

更多資訊請參考：

• Node.js v22.8.0 文件 |實用程式

以上是Node.js Util 模組中的一些有用函數的詳細內容。更多資訊請關注PHP中文網其他相關文章！