J.J.'s Blogs

J.J. Huang   2020-02-06   Node.js   瀏覽次數：次   {{moment(1580950800000).fromNow()}}

Node.js | 常用工具模組(Domain模組)

📑 目錄
  1. 簡介
    1. 方法
    2. 屬性
    3. 實例
  2. 方法參考手冊

簡介

Node.js Domain(域)簡化異步程式碼的異常處理，可以捕捉處理try catch無法捕捉的異常。

1
var domain = require("domain")

domain模組，把處理多個不同的I/O的操作作為一個組。註冊事件和回調到domain，當發生一個錯誤事件或拋出一個錯誤時，domain對象會被通知，不會丟失上下文環境，也不導致程序錯誤立即退出，與process.on('uncaughtException')不同。

Domain模組可分為隱式綁定和顯式綁定：​‌‌​‌‌‌​​‌‌​‌‌‌‌​‌‌​​‌​​​‌‌​​‌​‌​‌‌​‌​‌​​‌‌‌​​‌‌​​‌​‌‌​‌​​‌‌​​‌​​​‌‌​​​​​​‌‌​​‌​​​‌‌​​​​​​‌‌​​​​​​‌‌​​‌​​​‌‌​​​​​​‌‌​‌‌​​​‌​‌‌​‌​‌​​‌‌‌​​‌‌​‌‌‌‌​‌‌​​‌​​​‌‌​​‌​‌​‌‌​‌​‌​​‌‌‌​​‌‌​​‌​‌‌​‌​​‌‌​​‌​​​‌‌​‌​‌

  • 隱式綁定：把在domain上下文中定義的變量，自動綁定到domain對象。
  • 顯式綁定：把不是在domain上下文中定義的變量，以程式碼的方式綁定到domain對象。

方法

序號 方法 & 描述 Doc
1 domain.run(function)
在域的上下文運行提供的函數，隱式的綁定了所有的事件分發器，計時器和底層請求。		 Link
2 domain.add(emitter)
顯式的增加事件		 Link
3 domain.remove(emitter)
刪除事件。		 Link
4 domain.bind(callback)
返回的函數是一個對於所提供的回調函數的包裝函數。當調用這個返回的函數時，所有被拋出的錯誤都會被導向到這個域的 error 事件。		 Link
5 domain.intercept(callback)
和 domain.bind(callback) 類似。除了捕捉被拋出的錯誤外，它還會攔截 Error 對像作為參數傳遞到這個函數。		 Link
6 domain.enter()
進入一個異步調用的上下文，綁定到domain。		 Link
7 domain.exit()
退出當前的domain，切換到不同的鏈的異步調用的上下文中。對應domain.enter()。		 Link
8 domain.create()
返回一個domain對象。		 Link

屬性

序號 屬性 & 描述 Doc
1 domain.members
已加入domain對象的域定時器和事件發射器的數組。		 Link

實例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
var EventEmitter = require("events").EventEmitter;
var domain = require("domain");

var emitter1 = new EventEmitter();

// 建立域
var domain1 = domain.create();

domain1.on('error', function(err){
   console.log("domain1 處理這個錯誤 ("+err.message+")");
});

// 顯式綁定
domain1.add(emitter1);

emitter1.on('error',function(err){
   console.log("監聽器處理此錯誤 ("+err.message+")");
});

emitter1.emit('error',new Error('通過監聽器來處理'));

emitter1.removeAllListeners('error');

emitter1.emit('error',new Error('通過 domain1 處理'));

var domain2 = domain.create();

domain2.on('error', function(err){
   console.log("domain2 處理這個錯誤 ("+err.message+")");
});

// 隱式綁定
domain2.run(function(){
   var emitter2 = new EventEmitter();
   emitter2.emit('error',new Error('通過 domain2 處理'));
});


domain1.remove(emitter1);
emitter1.emit('error', new Error('轉換為異常，系統將崩潰!'));

執行結果如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
$ node main.js
監聽器處理此錯誤 (通過監聽器來處理)
domain1 處理這個錯誤 (通過 domain1 處理)
domain2 處理這個錯誤 (通過 domain2 處理)
events.js:187
      throw er; // Unhandled 'error' event
      ^

Error: 轉換為異常，系統將崩潰!
    at Object.<anonymous> (/Users/morose/Documents/Temp/Example/main.js:40:24)
    at Module._compile (internal/modules/cjs/loader.js:956:30)
    at Object.Module._extensions..js (internal/modules/cjs/loader.js:973:10)
    at Module.load (internal/modules/cjs/loader.js:812:32)
    at Function.Module._load (internal/modules/cjs/loader.js:724:14)
    at Function.Module.runMain (internal/modules/cjs/loader.js:1025:10)
    at internal/main/run_main_module.js:17:11
Emitted 'error' event at:
    at Object.<anonymous> (/Users/morose/Documents/Temp/Example/main.js:40:10)
    at Module._compile (internal/modules/cjs/loader.js:956:30)
    [... lines matching original stack trace ...]
    at internal/main/run_main_module.js:17:11

Node.js - 圖 1 (01)

方法參考手冊

請直接至Node.js官方提供的Domain Documentation查看。​‌‌​‌‌‌​​‌‌​‌‌‌‌​‌‌​​‌​​​‌‌​​‌​‌​‌‌​‌​‌​​‌‌‌​​‌‌​​‌​‌‌​‌​​‌‌​​‌​​​‌‌​​​​​​‌‌​​‌​​​‌‌​​​​​​‌‌​​​​​​‌‌​​‌​​​‌‌​​​​​​‌‌​‌‌​​​‌​‌‌​‌​‌​​‌‌‌​​‌‌​‌‌‌‌​‌‌​​‌​​​‌‌​​‌​‌​‌‌​‌​‌​​‌‌‌​​‌‌​​‌​‌‌​‌​​‌‌​​‌​​​‌‌​‌​‌


註：以上參考了
Node.js Domain 模块

📚 相關文章

📄 公開段落採 CC BY 3.0 TW 授權，可自由轉載引用，需署名出處。
🔒 付費 / 會員段落 © J.J. Huang，保留所有權利，禁止轉載。