hasOwnProperty() メソッドで JavaScript 関数の存在を確認する

2024-04-16

JavaScriptで関数が存在するかどうかを確認する方法

typeof演算子を使う

説明:

typeof 演算子は、オペランドのデータ型を文字列で返します。関数の場合、typeof 演算子は "function" を返します。

例:

function myFunction() {
  console.log("Hello, world!");
}

if (typeof myFunction === "function") {
  myFunction(); // 関数が存在するので実行
} else {
  console.log("myFunction is not a function");
}

出力:

Hello, world!

in演算子を使う

in 演算子は、オブジェクト内に指定したプロパティが存在するかどうかを調べます。関数はオブジェクトの一種なので、in 演算子を使って関数の存在を確認することができます。

function myFunction() {
  console.log("Hello, world!");
}

if (myFunction in window) {
  myFunction(); // 関数が存在するので実行
} else {
  console.log("myFunction does not exist");
}

Hello, world!

補足:

上記の例では、グローバルスコープにある関数 myFunction を確認しています。ローカルスコープにある関数を確認したい場合は、その関数を定義しているスコープ内で確認する必要があります。
関数が存在するかどうかを確認するだけでなく、関数が有効かどうかを確認することもできます。関数が無効になっている場合は、typeof 演算子は "function" を返し、in 演算子は true を返しますが、関数は実行できません。

上記以外にも、関数の存在を確認する方法はありますが、一般的には上記の2つの方法が最もよく使われます。状況に合わせて適切な方法を選択してください。

function checkFunctionExists1(functionName) {
  if (typeof functionName === "function") {
    console.log(functionName + " is a function");
  } else {
    console.log(functionName + " is not a function");
  }
}

checkFunctionExists1("myFunction"); // myFunction is a function
checkFunctionExists1("nonExistentFunction"); // nonExistentFunction is not a function

function checkFunctionExists2(functionName) {
  if (functionName in window) {
    console.log(functionName + " exists");
  } else {
    console.log(functionName + " does not exist");
  }
}

checkFunctionExists2("myFunction"); // myFunction exists
checkFunctionExists2("nonExistentFunction"); // nonExistentFunction does not exist

上記のコードは、checkFunctionExists1 と checkFunctionExists2 という2つの関数を提供します。
それぞれの関数は、引数として関数名をとり、その関数が存在するかどうかを確認します。
typeof 演算子を使った checkFunctionExists1 関数は、typeof 演算子の結果を console.log で出力します。
コードの最後には、それぞれの関数を実際に呼び出して動作を確認する例が示されています。

JavaScriptで関数が存在するかどうかを確認するその他の方法

try...catch ブロックを使う

try...catch ブロックを使用して、関数を呼び出す際のエラーを捕捉することで、関数が存在するかどうかを確認できます。

function checkFunctionExists3(functionName) {
  try {
    functionName();
    console.log(functionName + " exists");
  } catch (error) {
    if (error.name === "TypeError") {
      console.log(functionName + " is not a function");
    } else {
      console.error(error);
    }
  }
}

checkFunctionExists3("myFunction"); // myFunction exists
checkFunctionExists3("nonExistentFunction"); // nonExistentFunction is not a function

上記のコードは、checkFunctionExists3 という関数を提供します。
関数を呼び出す際に try...catch ブロックを使用します。
関数が存在し、正常に呼び出せる場合は、console.log でメッセージを出力します。
関数が存在しない、または呼び出せない場合は、catch ブロックでエラーを捕捉し、エラーの種類に応じて処理を行います。
エラーの種類が TypeError の場合は、関数が存在しないことを示すメッセージを出力します。

Object.keys() メソッドを使う

Object.keys() メソッドを使用して、オブジェクトのプロパティ名の配列を取得し、その中に確認したい関数が存在するかどうかを確認できます。

function checkFunctionExists4(functionName) {
  if (functionName in window) {
    console.log(functionName + " exists");
  } else {
    console.log(functionName + " does not exist");
  }
}

checkFunctionExists4("myFunction"); // myFunction exists
checkFunctionExists4("nonExistentFunction"); // nonExistentFunction does not exist

window オブジェクトの Object.keys() メソッドを使用して、グローバルスコープにあるプロパティ名の配列を取得します。
取得した配列に確認したい関数名が含まれているかどうかを確認します。

hasOwnProperty() メソッドを使う

hasOwnProperty() メソッドを使用して、オブジェクトが指定のプロパティを持っているかどうかを確認できます。この方法は、グローバルスコープだけでなく、任意のオブジェクトに対して関数が存在するかどうかを確認するために使用できます。

function checkFunctionExists5(object, functionName) {
  if (object.hasOwnProperty(functionName)) {
    console.log(functionName + " exists in " + object.name);
  } else {
    console.log(functionName + " does not exist in " + object.name);
  }
}

const myObject = {
  myFunction: function() {
    console.log("Hello, world!");
  }
};

checkFunctionExists5(window, "myFunction"); // myFunction exists in window
checkFunctionExists5(myObject, "myFunction"); // myFunction exists in myObject
checkFunctionExists5(myObject, "nonExistentFunction"); // nonExistentFunction does not exist in myObject