script

JavaScript の式、文、または一連の文を表す文字列です。式には、既存オブジェクトの変数およびプロパティを含められます。これはスクリプトとして解釈されますので、import 宣言（モジュールの中に存在しうる）は許可されていません。

与えられたコードの評価結果の値を返します。評価結果が空の場合は、undefined を返します。もしscript が文字列プリミティブでなければ、eval() は引数を変更せずに返します。

コードを評価している間に発生するあらゆる例外が発生します。もしscript がスクリプトとして解釈できなかった場合はSyntaxError になります。

eval() はグローバルオブジェクトの関数プロパティです。

eval() 関数の引数は文字列です。ソース文字列をスクリプト本体として評価します。つまり、文と式の両方が使用可能です。コードの完了値を返します。式の場合は、式が評価された値です。多くの文や宣言も同様に完了値を持ちますが、その結果は意外なものになることがあります（例えば、代入の完了値は代入された値ですが、let の完了値は undefined です）。そのため、文の完了値には頼らないことをお勧めします。

厳格モードでは、eval という名前の変数を宣言したり、eval に代入したりすることはSyntaxError になります。

"use strict";const eval = 1; // SyntaxError: Unexpected eval or arguments in strict mode

eval() の引数が文字列でない場合、eval() は引数を変更せずに返します。次の例では、プリミティブの代わりにString オブジェクトを渡すと、eval() は文字列を評価するのではなく、String オブジェクトを返します。

eval(new String("2 + 2")); // "2 + 2" を含む String オブジェクトを返すeval("2 + 2"); // 4 を返す

一般的な方法でこの課題をうまく回避するには、eval() に渡す前に、自分で引数を文字列に変換することができます。

const expression = new String("2 + 2");eval(String(expression)); // 4 を返します

eval() の呼び出しには、直接的な eval と間接的な eval の 2 つのモードがあります。直接的な eval はeval( ) が唯一の形です（呼び出す関数の名前はeval で、その値はグローバルなeval 関数です）。それ以外のすべて は、エイリアス変数経由、メンバーアクセスやその他の式経由、またはオプショナルチェーン?. 演算子を使用して呼び出すことも含めて、間接的なものです。

// eval を返すためにカンマ演算子を使用する間接的呼び出し(0, eval)("x + y");// オプショナルチェーンによる間接的呼び出しeval?.("x + y");// eval を格納し返すために変数を使用する間接的呼び出しconst geval = eval;geval("x + y");// メンバーアクセスによる間接的呼び出しconst obj = { eval };obj.eval("x + y");

間接的な eval は、コードが別個の<script> タグの中で評価されるように見ることができます。これはつまり次のような意味です。

• 間接的な eval はローカルスコープではなくグローバルスコープで動作し、評価されるコードは呼び出されるスコープ内のローカル変数にアクセスすることはありません。

  js

  function test() {  const x = 2;  const y = 4;  // 直接呼び出し、ローカルスコープを使用  console.log(eval("x + y")); // 結果は 6  // eval を返すカンマ演算子を使用した間接呼び出し  console.log(eval?.("x + y")); // グローバルスコープを使用、x は未定義のため例外が発生}

• 間接的なeval は周囲のコンテキストの厳格さを継承せず、ソース文字列自体に"use strict" ディレクティブがある場合にのみ厳格モード になります。

  js

  function strictContext() {  "use strict";  eval?.(`with (Math) console.log(PI);`);}function strictContextStrictEval() {  "use strict";  eval?.(`"use strict"; with (Math) console.log(PI);`);}strictContext(); // Logs 3.141592653589793strictContextStrictEval(); // 文字列が厳格モードであるため SyntaxError を発生します。

  一方、直接的な eval は、呼び出すコンテキストの厳格さを継承します。

  js

  function nonStrictContext() {  eval(`with (Math) console.log(PI);`);}function strictContext() {  "use strict";  eval(`with (Math) console.log(PI);`);}nonStrictContext(); // Logs 3.141592653589793strictContext(); // 厳格モードなので SyntaxError が発生します。

• もしソース文字列が厳格モードで解釈されていない場合、var で宣言された変数と関数宣言 は周囲のスコープに入ってしまいます。厳格モードのコンテキストでの直接的な eval であった場合、またはeval のソース文字列自体が厳格モードであった場合、var と関数宣言は周囲のスコープに「漏れる」ことはありません。

  js

  // コンテキストもソース文字列も厳格モードではないため、 var は周囲のスコープで変数を作成します。eval("var a = 1;");console.log(a); // 1// コンテキストは厳格ではありませんが、 eval のソースは厳格なので、 b は評価されたスクリプトにスコープされます。eval("'use strict'; var b = 1;");console.log(b); // ReferenceError: b is not definedfunction strictContext() {  "use strict";  // コンテキストは厳格ですが、これは間接的なもので、文字列は厳格ではありません。  eval?.("var c = 1;");  // 厳密なコンテキストでのディレクティブ eval なので、 d はスコープされます。  eval("var d = 1;");}strictContext();console.log(c); // 1console.log(d); // ReferenceError: d is not defined

  評価される文字列内のlet およびconst 宣言は、常にそのスクリプトにスコープされます。

• ディレクティブ eval は追加のコンテキスト式にアクセスすることができます。例えば、関数の本体でnew.target を使用することができます。

  js

  function Ctor() {  eval("console.log(new.target)");}new Ctor(); // [Function: Ctor]

直接的なeval() はいくつもの問題を引き起こします。

• eval() は呼び出し元の権限で渡されたコードを実行します。悪意のある第三者に影響を受ける可能性のある文字列でeval() を実行すると、そのウェブページや拡張機能の権限において、ユーザーのマシン上で悪意のあるコードを実行してしまう可能性があります。さらに重要なことに、サードパーティのコードがeval() が（直接的な eval であれば）呼び出されたスコープを見ることができるため、攻撃者がローカル変数を読み取ったり変更したりすることができてしまいます。
• 現代の JavaScript では多くの構造が JS エンジンによって最適化されているため、eval() は他の方法よりも低速です。
• 現代の JavaScript インタープリターは JavaScript を機械語に変換します。これは、変数の名前の概念がすべて消滅することを意味します。したがって、eval() を使用すると、ブラウザーは長い高価な変数名検索を実行して、変数が機械語のどこに存在しているかを把握し、その値を設定します。さらに、eval() が変数の型の変更など、その変数に新しい変数をもたらす可能性もあり、生成されたすべての機械語を再評価して補正させられる可能性があります。
• スコープがeval() によって推移的に依存されている場合、ミニファイヤーはミニ化をあきらめます。そうしないとeval() は実行時に正しい変数を読み込むことができないからです。

eval() や関連のメソッドを使用することで、最適化したり、完全に避けることができる用途はたくさんあります。

間接的 eval() の使用

このコードを考えてみてください。

function looseJsonParse(obj) {  return eval(`(${obj})`);}console.log(looseJsonParse("{ a: 4 - 1, b: function () {}, c: new Date() }"));

間接的 eval を使用して厳格モードを強制するだけで、コードはずっと良くなります。

function looseJsonParse(obj) {  return eval?.(`"use strict";(${obj})`);}console.log(looseJsonParse("{ a: 4 - 1, b: function () {}, c: new Date() }"));

上記の 2 つのコードスニペットは同じように動作するように見えるかもしれませんが、そうではありません。前者は直接的 eval を使用しているので、複数の問題が発生します。

• より多くの範囲を検査するため、非常に時間がかかります。評価される文字列中のc: new Date() に注目してください。間接的 eval のバージョンでは、オブジェクトはグローバルスコープで評価されるので、インタープリターはDate がDate という名前のローカル変数ではなく、グローバルなDate() コンストラクターを参照しているとみなされます。しかし、直接的 eval を使用するコードでは、インタープリターはこれを想定することができません。例えば、次の例では、評価された文字列のDate はwindow.Date() を参照しません。

  js

  function looseJsonParse(obj) {  function Date() {}  return eval(`(${obj})`);}console.log(looseJsonParse(`{ a: 4 - 1, b: function () {}, c: new Date() }`));

  したがって、このeval() バージョンでは、ブラウザーは高価なルックアップ呼び出しを行い、Date() というローカル変数があるかどうかを確認します。

• 厳格モードを使用していない場合、eval() ソース内のvar 宣言は周囲のスコープの変数になります。これは、文字列が外部入力から取得された場合、特に同じ名前の既存の変数がある場合に、デバッグしにくい課題につながります。

• 直接的 eval は、周囲のスコープのバインディングを読み込んだり、変更したりすることができます。

• 直接的eval を使用する場合、特に eval ソースが厳格モードであることを証明できない場合、eval() ソースはその周囲のスコープ内の任意の変数名に依存することができるため、エンジン（およびビルドツール）はインライン化に関連するすべての最適化を無効にしなければなりません。

しかし、間接的なeval() を使用すると、評価されたソースが読み込む既存のグローバル変数以外の追加のバインディングを渡すことができません。評価されるソースがアクセスすべき追加の変数を指定する必要がある場合は、コンストラクターFunction() を使用することを検討してください。

Function() コンストラクターの使用

Function() コンストラクターは、上記の間接的 eval の例ととてもよく似ています。グローバルスコープで渡された JavaScript ソースを、ローカルバインディングを読み込んだり変更したりすることなく評価するので、エンジンは直接eval() を実行するよりも多くの最適化を実行することができます。

eval() とFunction()の異なる点は、Function()に渡された文字列はスクリプトとしてではなく、関数本体として解釈できるということです。例えば、関数本体の最上位ではreturn 文を使用することができますが、スクリプトの中では使用できません。

Function() コンストラクターは、変数を引数として渡して eval ソース内でローカルバインディングを作成したい場合に有益です。

function Date(n) {  return [    "Monday",    "Tuesday",    "Wednesday",    "Thursday",    "Friday",    "Saturday",    "Sunday",  ][n % 7 || 0];}function runCodeWithDateFunction(obj) {  return Function("Date", `"use strict";return (${obj});`)(Date);}console.log(runCodeWithDateFunction("Date(5)")); // Saturday

eval() とFunction() はどちらも暗黙的に任意のコードを評価するので、厳格なCSP 設定では禁止されています。また、一般的な用途ではeval() やFunction() に代わる、より安全な（そして、より高速な）方法が他にもあります。

ブラケットアクセサーの使用

プロパティ名からプロパティ自体への変換を行うためにeval() を使用しないでください。アクセスされるオブジェクトのプロパティがコードが実行されるまでわからない場合の例を考えてみましょう。これはeval() で行うことができます。

const obj = { a: 20, b: 30 };const propName = getPropName(); // returns "a" or "b"const result = eval(`obj.${propName}`);

ただし、ここでeval() は必要ありません。実際、この使い方はお勧めできません。なぜならpropName が有効な識別子でないと構文エラーになるからです。さらに、getPropName が制御する関数でない場合、任意のコードを実行してしまう可能性があります。代わりにプロパティアクセサーを使用したほうが、より速くて安全です。

const obj = { a: 20, b: 30 };const propName = getPropName(); // "a" または "b" が返されるconst result = obj[propName]; // obj[ "a" ] は obj.a と同じ

このメソッドを使用して子孫プロパティにアクセスすることもできます。eval() を使うと以下のようになります。

const obj = { a: { b: { c: 0 } } };const propPath = getPropPath(); // "a.b.c" などを返すconst result = eval(`obj.${propPath}`); // 0

ここでeval() を回避するには、プロパティのパスを分割し、様々なプロパティをループすることで行うことができます。

function getDescendantProp(obj, desc) {  const arr = desc.split(".");  while (arr.length) {    obj = obj[arr.shift()];  }  return obj;}const obj = { a: { b: { c: 0 } } };const propPath = getPropPath(); // "a.b.c" などを返すconst result = getDescendantProp(obj, propPath);

プロパティの設定も同様に行うことができます。

function setDescendantProp(obj, desc, value) {  const arr = desc.split(".");  while (arr.length > 1) {    obj = obj[arr.shift()];  }  return (obj[arr[0]] = value);}const obj = { a: { b: { c: 0 } } };const propPath = getPropPath(); // "a.b.c" などを返すconst result = setDescendantProp(obj, propPath, 1); // obj.a.b.c は 1 になる

しかし、制約のない入力でブラケットアクセッサを使用することも安全ではありません。オブジェクトインジェクション攻撃を許す可能性もあります。

コールバックの使用

JavaScript第一級関数を備えており、関数を他の API の引数としたり、変数やオブジェクトのプロパティに保存したりすることができます。多くの DOM API はこれを考慮して作られているので、次のように書くことができます（また、書くべきです）。

// setTimeout(" ... ", 1000) を使う代わりにsetTimeout(() => {  // …}, 1000);// elt.setAttribute("onclick", "…") を使う代わりにelt.addEventListener("click", () => {  // …});

文字列を連結せずにパラメーター化した関数を作成する方法としては、クロージャを使う方法も便利です。

eval() の呼び出しに使おうとしている文字列がコードではなくデータ（例えば"[1, 2, 3]" で配列を表す）を含むものであれば、JSON に切り替えることを検討してください。これは JavaScript のサブセットを使用することで、文字列でデータを表現することができます。

JSON の構文は JavaScript の構文に比べて制限があり、多くの有効な JavaScript リテラルが JSON としては解釈されないことに注意してください。例えば、最後にカンマを付けることは JSON では許されておらず、オブジェクトリテラル内のプロパティ名（キー）は引用符で囲む必要があります。後で JSON として解析される文字列を生成するには、JSON シリアライザーを使うようにしてください。

任意のコードではなく、注意深く制約されたデータを渡すことは、一般的によい考えです。例えば、ウェブページの内容を取得できるよう設計された拡張であれば、JavaScript コードの代わりにXPath を使って取得ルールを定義できます。

次のコードでは、eval を含むどちらの文も 42 を返します。最初のコードは文字列 "x + y + 1" を評価します。2 番目のコードは文字列 "42" を評価します。

const x = 2;const y = 39;const z = "42";eval("x + y + 1"); // 42 が返されるeval(z); // 42 が返される

eval() は最後に評価された式の値を返します。if については、評価された最後の式または文になります。

const str = "if (a) { 1 + 1 } else { 1 + 2 }";let a = true;let b = eval(str); // 2 が返されるconsole.log(`b is: ${b}`); // b is: 2a = false;b = eval(str); // 3 が返されるconsole.log(`b is: ${b}`); // b is: 3

次の例ではeval() を使用して文字列str を評価しています。この文字列は、x が 5 であればz に 42 という値を割り当てる、そうでなければz に 0 を代入するという JavaScript の文で構成されています。 2 つ目の文が実行されると、eval() はこれらの文を発生させ、文の集合も評価してz に代入された値を返します。

const x = 5;const str = `if (x === 5) {  console.log("z is 42");  z = 42;} else {  z = 0;}`;console.log("z is ", eval(str)); // z is 42  z is 42

複数の値を割り当てる場合は、最後の値を返します。

let x = 5;const str = `if (x === 5) {  console.log("z is 42");  z = 42;  x = 420;} else {  z = 0;}`;console.log("x is", eval(str)); // z is 42  x is 420

• プロパティアクセサー
• WebExtensions: コンテンツスクリプトでの eval() の使用