NodeJs - emitter.prependOnceListener() 方法

當我們使用emitter.once() 或 emitter.on() 方法新增監聽器函式時，它將被新增到監聽器陣列的末尾，並且最後被呼叫。透過呼叫emitter.prependOnceListener() 方法，它會在其他監聽器之前新增並呼叫。

此方法屬於Eventemitter 類，它是 node:events 模組的內建類。

語法

以下是 NodeJs emitter.prependOnceListener() 方法的語法：

emitter.prependOnceListener(eventName, listener)

引數

此方法接受兩個引數，如下所述。

• eventName：這是方法的第一個引數，它儲存事件的名稱。它可以是字串或符號。
• listener：此引數儲存回撥函式。

返回值

此方法返回對 EventEmitter 的引用，以便可以連結呼叫

示例 1

以下是 NodeJs emitter.prependOnceListener() 方法的基本示例。

在這裡，我們建立了四個函式 f1、f2、f3 和 f4，並在其中包含一條訊息。然後我們使用 myEmitter.on() 方法呼叫了 f1、f2 和 f3。它將根據呼叫的順序新增監聽器函式。稍後，我們使用 emitter.prependOnceListener() 方法呼叫了監聽器函式 f4。因此，f4 將新增到監聽器陣列的開頭。如果我們編譯並執行程式，f4 將首先返回，然後是其餘的。

const EventEmitter = require('node:events');
const myEmitter = new EventEmitter();

function f1(){
  console.log("Func1 is added");
}

function f2(){
  console.log("Fucn2 is added");
}

function f3(){
  console.log("Fucn3 is added");
}

function f4(){
  console.log("Fucn4 is added");
}

myEmitter.on("myEvent", f1);
myEmitter.on("myEvent", f2);
myEmitter.on("myEvent", f3);
myEmitter.prependOnceListener("myEvent", f4);

myEmitter.emit("myEvent");

輸出

以上程式產生以下輸出：

Fucn4 is added
Func1 is added
Fucn2 is added
Fucn3 is added

示例 2

在此程式中，我們建立了四個函式 f1、f2、f3 和 f4，並在其中包含一條訊息。然後我們使用 myEmitter.on() 方法呼叫了所有四個函式，並且我們沒有使用 emitter.prependOnceListener() 方法呼叫任何函式。因此，當我們編譯並執行程式時，myEmitter.on() 方法將根據呼叫的順序返回監聽器函式。

const EventEmitter = require('node:events');
const myEmitter = new EventEmitter();

function f1(){
  console.log("Func1 is added");
}

function f2(){
  console.log("Fucn2 is added");
}

function f3(){
  console.log("Fucn3 is added");
}

function f4(){
  console.log("Fucn4 is added");
}

myEmitter.on("myEvent", f1);
myEmitter.on("myEvent", f2);
myEmitter.on("myEvent", f3);
myEmitter.on("myEvent", f4);

myEmitter.emit("myEvent");

輸出

以上程式產生以下輸出：

Func1 is added
Fucn2 is added
Fucn3 is added
Fucn4 is added

示例 3

emitter.prependOnceListener() 將為 eventName “anEvent” 新增一個一次性監聽器到監聽器陣列的開頭。當我們編譯並執行程式時，它將把監聽器函式新增到監聽器陣列的開頭。

const EventEmitter = require('node:events');
const myEmitter = new EventEmitter();

myEmitter.prependOnceListener("anEvent", (f1) => {
  console.log('Aye, nice to meet you');
});

myEmitter.prependOnceListener("anEvent", (f1) => {
  console.log('Aye, Hello');
});


myEmitter.emit("anEvent");

輸出

以上程式產生以下輸出：

Aye, Hello
Aye, nice to meet you