【Node.js24.x】Function::apply()メソッドの使い方

applyメソッドは、指定されたthisの値と、配列として提供される引数を使って関数を実行するメソッドです。JavaScriptでは、関数が実行される際のthisの値は、その関数がどのように呼び出されたかによって決定されますが、applyメソッドを使用すると、開発者が明示的にthisの値を設定できます。これにより、オブジェクトのメソッドを別のオブジェクトのコンテキストで実行したり、特定のスコープ内で関数を呼び出したりする際に非常に役立ちます。

このメソッドは主に2つの引数を取ります。最初の引数は、関数内でthisとして使用したいオブジェクトです。もしnullやundefinedを渡した場合、非厳格モードではグローバルオブジェクト（Node.jsではglobal）がthisとなり、厳格モードではundefinedがthisとなります。2番目の引数は、関数に渡す引数を要素として持つ配列、または配列ライクなオブジェクトです。これにより、引数の数が前もって決まっていない場合や、動的に引数を生成して関数に渡したい場合に柔軟に対応できます。

例えば、ある配列の要素を全て、別の関数への個別の引数として渡したい場合などに、applyメソッドは簡潔かつ強力な解決策となります。このように、applyメソッドは関数の呼び出し方を細かく制御し、多様なプログラミングパターンを可能にする基本的な機能の一つです。

Copy
1function greet(greeting, punctuation) {
2  console.log(`${greeting}, ${this.name}${punctuation}`);
3}
4
5const person = { name: "Alice" };
6const args = ["Hello", "!"];
7
8greet.apply(person, args);

thisArg, argsArray = undefined

• thisArg: 関数を実行する際の this の値を指定するオブジェクト。指定しない場合は undefined となります。
• argsArray: 関数に渡す引数を配列または配列ライクなオブジェクトで指定します。省略した場合、引数は渡されません。

呼び出された関数の戻り値

apply メソッドは、指定したコンテキスト（this の値）と引数の配列（または配列風オブジェクト）を用いて関数を呼び出し、その結果として関数が返した値を返します。