From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- .../functions/arguments/@@iterator/index.html | 63 ++++++ .../functions/arguments/callee/index.html | 158 ++++++++++++++ .../functions/arguments/caller/index.html | 56 +++++ .../reference/functions/arguments/index.html | 227 +++++++++++++++++++++ .../functions/arguments/length/index.html | 124 +++++++++++ 5 files changed, 628 insertions(+) create mode 100644 files/ja/web/javascript/reference/functions/arguments/@@iterator/index.html create mode 100644 files/ja/web/javascript/reference/functions/arguments/callee/index.html create mode 100644 files/ja/web/javascript/reference/functions/arguments/caller/index.html create mode 100644 files/ja/web/javascript/reference/functions/arguments/index.html create mode 100644 files/ja/web/javascript/reference/functions/arguments/length/index.html (limited to 'files/ja/web/javascript/reference/functions/arguments') diff --git a/files/ja/web/javascript/reference/functions/arguments/@@iterator/index.html b/files/ja/web/javascript/reference/functions/arguments/@@iterator/index.html new file mode 100644 index 0000000000..e0690a49af --- /dev/null +++ b/files/ja/web/javascript/reference/functions/arguments/@@iterator/index.html @@ -0,0 +1,63 @@ +--- +title: 'arguments[@@iterator]()' +slug: Web/JavaScript/Reference/Functions/arguments/@@iterator +tags: + - Functions + - JavaScript + - Property + - arguments +translation_of: Web/JavaScript/Reference/Functions/arguments/@@iterator +--- +
{{jsSidebar("Functions")}}
+ +

@@iterator プロパティの初期値は {{jsxref("Array.prototype.values")}} プロパティの初期値と同じ関数オブジェクトです。

+ +

構文

+ +
arguments[Symbol.iterator]()
+ +

+ +

for...of ループを用いた反復

+ +
function f() {
+  // your browser must support for..of loop
+  // and let-scoped variables in for loops
+  for (let letter of arguments) {
+    console.log(letter);
+  }
+}
+f('w', 'y', 'k', 'o', 'p');
+
+ +

仕様書

+ + + + + + + + + + + + + + + +
仕様書
{{SpecName('ESDraft', '#sec-createunmappedargumentsobject', 'CreateUnmappedArgumentsObject')}}
{{SpecName('ESDraft', '#sec-createmappedargumentsobject', 'CreateMappedArgumentsObject')}}
+ +

ブラウザーの互換性

+ +
+ + +

{{Compat("javascript.functions.arguments.@@iterator")}}

+
+ +

関連情報

+ + diff --git a/files/ja/web/javascript/reference/functions/arguments/callee/index.html b/files/ja/web/javascript/reference/functions/arguments/callee/index.html new file mode 100644 index 0000000000..a9dd72897a --- /dev/null +++ b/files/ja/web/javascript/reference/functions/arguments/callee/index.html @@ -0,0 +1,158 @@ +--- +title: arguments.callee +slug: Web/JavaScript/Reference/Functions/arguments/callee +tags: + - Deprecated + - JavaScript + - Reference + - arguments + - プロパティ + - 関数 +translation_of: Web/JavaScript/Reference/Functions/arguments/callee +--- +
{{jsSidebar("Functions")}}
+ +

arguments.callee プロパティは現在実行中の関数を示します。

+ +

説明

+ +

calleearguments オブジェクトのプロパティです。関数の本体の内部で現在実行中の関数を参照するために使用します。これは関数名が不明であるとき、たとえば名前のない関数式(「無名関数」)の内部などで便利です。

+ +
警告: ECMAScript 第5版では、 strict モードにおける arguments.callee() の使用を禁止しています。関数式に名前を付けるか、関数が自身を呼び出す必要がある場合に関数宣言を使用するかして arguments.callee() の使用を避けてください。
+ +

なぜ arguments.callee は ES5 strict mode で削除されたのか

+ +

olliej による Stack Overflow の回答によれば)

+ +

古いバージョンの JavaScript では名前付きの関数式が利用できず、このため再帰の関数式を作成することができませんでした。

+ +

例えば、以下の構文は動作しました。

+ +
function factorial (n) {
+    return !(n > 1) ? 1 : factorial(n - 1) * n;
+}
+
+[1, 2, 3, 4, 5].map(factorial);
+ +

しかし、

+ +
[1, 2, 3, 4, 5].map(function(n) {
+    return !(n > 1) ? 1 : /*ここでどうする?*/ (n - 1) * n;
+});
+ +

は動作しませんでした。これをうまくやるために arguments.callee が追加され、あなたは以下のようなことができます。

+ +
[1, 2, 3, 4, 5].map(function(n) {
+    return !(n > 1) ? 1 : arguments.callee(n - 1) * n;
+});
+ +

しかし、これは実際には本当にダメな解決法でした。これは(他の arguments や calleecaller の問題と組み合わさって)、一般的には、再帰のインライン化と末尾再帰が不可能になるのです(あなたはこれをトレースなどを通じて選択した場合では達成できます。しかし最良のコードであっても、逆に不要な検査においては最適未満です)。他の大きな問題としては、再帰呼び出しが別の this の値になることです。例えば、

+ +
var global = this;
+
+var sillyFunction = function(recursed) {
+    if (!recursed) { return arguments.callee(true); }
+    if (this !== global) {
+        alert('This is: ' + this);
+    } else {
+        alert('This is the global');
+    }
+}
+
+sillyFunction();
+ +

ECMAScript 3 は、名前付き関数式を許可することでこれらの問題を解決しました。例えば:

+ +
[1, 2, 3, 4, 5].map(function factorial(n) {
+    return !(n > 1) ? 1 : factorial(n - 1)*n;
+});
+ +

これには多くの利点があります:

+ + + +

Another feature that was deprecated was arguments.callee.caller, or more specifically Function.caller. Why is this? Well, at any point in time you can find the deepest caller of any function on the stack, and as I said above looking at the call stack has one single major effect: it makes a large number of optimizations impossible, or much much more difficult. For example, if you cannot guarantee that a function f will not call an unknown function, it is not possible to inline f. Basically it means that any call site that may have been trivially inlinable accumulates a large number of guards:

+ +
function f(a, b, c, d, e) { return a ? b * c : d * e; }
+ +

If the JavaScript interpreter cannot guarantee that all the provided arguments are numbers at the point that the call is made, it needs to either insert checks for all the arguments before the inlined code, or it cannot inline the function. Now in this particular case a smart interpreter should be able to rearrange the checks to be more optimal and not check any values that would not be used. However in many cases that's just not possible and therefore it becomes impossible to inline.

+ +

+ +

例: 無名再帰関数内での arguments.callee の使用

+ +

再帰関数は自分自身を参照する必要があります。関数が自分自身を参照するには、一般的には関数の名前を使用します。しかしながら、無名関数には名前がありません。さらにその無名関数を参照するアクセス可能な変数も無い(関数がどの変数にも代入されていない)場合、その関数には自分自身を参照する手段がありません(無名関数は関数式または Function コンストラクターによって作成できます)。したがって、これを参照するアクセス可能な変数がない場合、関数が自分自身を参照できる唯一の方法は arguments.callee による方法です。

+ +

次の例では関数を定義し、その関数内でさらに階乗関数を定義し、それを返しています。

+ +
function create() {
+   return function(n) {
+      if (n <= 1)
+         return 1;
+      return n * arguments.callee(n - 1);
+   };
+}
+
+var result = create()(5); // 120 (5 * 4 * 3 * 2 * 1) を返す
+ +

良い代替手段がない場合の arguments.callee の使用

+ +

ただし次のような場合、 arguments.callee に代わるものが無いために、その非推奨はバグである可能性があります ( {{Bug("725398")}} を参照):

+ +
function createPerson(sIdentity) {
+    var oPerson = new Function('alert(arguments.callee.identity);');
+    oPerson.identity = sIdentity;
+    return oPerson;
+}
+
+var john = createPerson('John Smith');
+
+john();
+ +

仕様策定状況

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
仕様書状況コメント
{{SpecName('ES1')}}{{Spec2('ES1')}}初回定義。 JavaScript 1.2 で実装
{{SpecName('ES5.1', '#sec-10.6', 'Arguments Object')}}{{Spec2('ES5.1')}}
{{SpecName('ES6', '#sec-arguments-exotic-objects', 'Arguments Exotic Objects')}}{{Spec2('ES6')}}
{{SpecName('ESDraft', '#sec-arguments-exotic-objects', 'Arguments Exotic Objects')}}{{Spec2('ESDraft')}}
+ +

ブラウザー実装状況

+ + + +

{{Compat("javascript.functions.arguments.callee")}}

+ +

関連項目

+ + diff --git a/files/ja/web/javascript/reference/functions/arguments/caller/index.html b/files/ja/web/javascript/reference/functions/arguments/caller/index.html new file mode 100644 index 0000000000..3626d7644b --- /dev/null +++ b/files/ja/web/javascript/reference/functions/arguments/caller/index.html @@ -0,0 +1,56 @@ +--- +title: caller +slug: Web/JavaScript/Reference/Functions/arguments/caller +translation_of: Archive/Web/JavaScript/arguments.caller +--- +

 

+ +

{{ Obsolete_header() }}

+ +

{{ 英語版章題("Summary") }}

+ +

概要

+ +

現在実行している関数を呼び出した関数を示します。

+ + + + + + + + + + + +
arguments のプロパティ
実装されたバージョン:JavaScript 1.1, NES 2.0 +

JavaScript 1.3: 非推奨とする。JavaScript ??: Removed

+
+ +

{{ 英語版章題("Description") }}

+ +

説明

+ +

arguments.caller はもはや使用されていません。 代わりに関数オブジェクトの非標準の {{jsxref("Function.caller")}} プロパティが使えます。詳細はその説明を参照してください。

+ +

arguments.caller プロパティは関数本体の中でのみ利用可能です。

+ +

{{ 英語版章題("Examples") }}

+ +

+ +

次のコードは、関数の中で arguments.caller の値をチェックします。

+ +
function myFunc() {
+   if (arguments.caller == null) {
+      return ("The function was called from the top!");
+   } else
+      return ("This function's caller was " + arguments.caller);
+}
+
+ +

 

+ +

 

+ +

{{ languages( { "en": "en/JavaScript/Reference/Functions_and_function_scope/arguments/caller", "fr": "fr/R\u00e9f\u00e9rence_de_JavaScript_1.5_Core/Fonctions/arguments/caller", "pl": "pl/Dokumentacja_j\u0119zyka_JavaScript_1.5/Funkcje/arguments/caller" } ) }}

diff --git a/files/ja/web/javascript/reference/functions/arguments/index.html b/files/ja/web/javascript/reference/functions/arguments/index.html new file mode 100644 index 0000000000..4990f359bc --- /dev/null +++ b/files/ja/web/javascript/reference/functions/arguments/index.html @@ -0,0 +1,227 @@ +--- +title: arguments +slug: Web/JavaScript/Reference/Functions/arguments +tags: + - Functions + - JavaScript + - Namespace + - Reference + - arguments + - 名前空間 +translation_of: Web/JavaScript/Reference/Functions/arguments +--- +
{{JSSidebar("Functions")}}
+ +

arguments配列風 (Array-like) オブジェクトであり、関数に渡された引数の値を含んでおり、関数内からアクセスすることができます。

+ +
{{EmbedInteractiveExample("pages/js/functions-arguments.html")}}
+ + + +

解説

+ +
+

注: ES6 互換のコードを書く場合は、残余引数が推奨されます。

+
+ +
+

注: 「配列風」とは、 arguments が {{jsxref("Functions/arguments/length", "length")}} プロパティと 0 から始まる添字のプロパティを持っているものの、 {{JSxRef("Array")}} の組込みメソッド、例えば {{jsxref("Array.forEach", "forEach()")}} や {{jsxref("Array.map", "map()")}} を持っていないということです。詳しくは 解説の節を見てください。

+
+ +

arguments オブジェクトはすべての(アローではない)関数内で利用可能なローカル変数です。arguments オブジェクトを使うことにより、関数内で関数の引数を参照できます。このオブジェクトは、関数に渡された各引数に対する入力を含みます。最初の入力の添え字は 0 から始まります。

+ +

たとえば、もし関数に 3 つの引数が渡されたなら、次のようにその引数を参照できます。

+ +
arguments[0] // 1 番目の引数
+arguments[1] // 2 番目の引数
+arguments[2] // 3 番目の引数
+
+ +

引数を設定したり再代入したりすることもできます。

+ +
arguments[1] = 'new value';
+
+ +

arguments オブジェクトは {{jsxref("Array")}} ではありません。似ていますが、 Array のプロパティは {{jsxref("Array.length", "length")}} 以外ありません。たとえば、 {{jsxref("Array.pop", "pop()")}} メソッドはありません。

+ +

しかしながら、本当の Array に変換することはできます。

+ +
var args = Array.prototype.slice.call(arguments);
+// 配列リテラルを使用すると上記よりも短くなりますが、空の配列を作成します
+var args = [].slice.call(arguments);
+
+ +

arguments に限らず、配列様オブジェクトは ES2015 の {{jsxref("Array.from()")}} メソッドやスプレッド構文によって、本当の配列に変換することができます。

+ +
var args = Array.from(arguments);
+var args = [...arguments];
+
+ +

arguments オブジェクトは、あらかじめ定義された引数の数よりも多くの引数で呼び出される関数に便利です。このテクニックは Math.min() などの 可変数の引数を受け入れる関数に便利です。この例の関数は、任意の数の文字列が引数で、引数の中で一番長い文字列を返します。

+ +
function longestString() {
+  var longest = '';
+  for (var i=0; i < arguments.length; i++) {
+    if (arguments[i].length > longest.length) {
+      longest = arguments[i];
+    }
+  }
+  return longest;
+}
+
+ +

呼び出された関数に渡された引数を数えるために {{jsxref("Functions/arguments/length", "arguments.length")}} を使用することができます。関数が受け取る引数を数えたいのであれば、関数の {{jsxref("Function.length", "length")}} プロパティを調べてください。

+ +

arguments に対する typeof の使用

+ +

{{jsxref("Operators/typeof", "typeof")}} 演算子を arguments に対して使用すると、 'object' が返されます。

+ +
console.log(typeof arguments); // 'object' 
+ +

個々の引数の型は、 arguments に添字を使用して判断することができます。

+ +
console.log(typeof arguments[0]); // 最初の引数の型を返す
+ +

プロパティ

+ +
+
{{jsxref("Functions/arguments/callee", "arguments.callee")}}
+
個の引数が所属する、現在実行中の関数を参照します。厳格モードでは禁止されています。
+
{{jsxref("Functions/arguments/length", "arguments.length")}}
+
関数に渡された引数の数を示します。
+
{{jsxref("Functions/arguments/@@iterator", "arguments[@@iterator]")}}
+
新しい {{jsxref("Array/@@iterator", "Array iterator", "", 0)}} オブジェクトで、 arguments のそれぞれの要素の値を含みます。
+
+ +

+ +

複数の文字列を連結する関数を定義する

+ +

この例では、複数の文字列を連結する関数を定義します。この関数の唯一の仮引数は、連結する項目を区切る文字を指定する文字列です。この関数は次のように定義されます。

+ +
function myConcat(separator) {
+  let args = Array.prototype.slice.call(arguments, 1);
+  return args.join(separator);
+}
+ +

この関数へは好きな数だけ引数を渡すことができます。これはリスト中のそれぞれの引数を使用した文字列リストを返します。

+ +
// "red, orange, blue" を返します
+myConcat(', ', 'red', 'orange', 'blue');
+
+// "elephant; giraffe; lion; cheetah" を返します
+myConcat('; ', 'elephant', 'giraffe', 'lion', 'cheetah');
+
+// "sage. basil. oregano. pepper. parsley" を返します
+myConcat('. ', 'sage', 'basil', 'oregano', 'pepper', 'parsley');
+ +

HTML のリストを作る関数の定義

+ +

この例では、リストのための HTML を含む文字列を作る関数を定義します。この関数の第 1 引数には、順不同リスト (中黒付き) なら "u"、順序リスト (番号付き) なら "o" を指定します。関数は次のように定義します。

+ +
function list(type) {
+  var html = '<' + type + 'l><li>';
+  var args = Array.prototype.slice.call(arguments, 1);
+  html += args.join('</li><li>');
+  html += '</li></' + type + 'l>'; // end list
+  return html;
+}
+ +

この関数には任意の数の引数を渡すことができ、それぞれの引数を指定された型のリストに項目として追加します。例を示します。

+ +
var listHTML = list('u', 'One', 'Two', 'Three');
+
+/* listHTML の内容は以下のような文字列となります。
+"<ul><li>One</li><li>Two</li><li>Three</li></ul>"
+*/
+ +

残余引数、デフォルト引数、分割引数

+ +
+

arguments オブジェクトを 残余デフォルト分割引数と組み合わせて使用できます。

+
+ +
function foo(...args) {
+  return args;
+}
+foo(1, 2, 3); // [1, 2, 3]
+
+ +

厳格モードのコードでは、残余引数、デフォルト引数、分割引数があっても arguments オブジェクトの動作は変わりませんが、厳格モードでない場合は微妙な違いがあります。

+ +

厳格モードでは、 arguments オブジェクトは関数に残余引数、デフォルト引数、分割引数が渡されたかどうかにかかわらず同じ動作をします。すなわち、関数の本体で変数に新しい値を代入しても、 arguments オブジェクトには影響しません。また、 arguments オブジェクトに新しい変数を代入しても、変数の値には影響ありません。

+ +
+

注: "use strict"; ディレクティブを、残余引数、デフォルト引数、分割引数を受け付ける関数の本体に書くことはできません。そうすると、構文エラーが発生します。

+
+ +

厳格モードでない関数で、単純な引数のみを渡した場合 (すなわち、残余引数、デフォルト引数、分割引数ではない場合)、関数の本体で変数の値を新しい値にすると、 arguments オブジェクトと同期します。

+ +
function func(a) {
+  arguments[0] = 99; // arguments[0] を更新すると a も更新される
+  console.log(a);
+}
+func(10); // 99
+
+ +

および

+ +
function func(a) {
+  a = 99; // a を更新すると arguments[0] も更新される
+  console.log(arguments[0]);
+}
+func(10); // 99
+
+ +

それに対して、厳格モードでない関数で、残余引数、デフォルト引数、分割引数が渡されると、関数の本体で引数の変数に新しい値が代入されても、 arguments オブジェクトと同期されません。複雑な引数を持つ厳格モードでない関数の arguments オブジェクトは、関数が呼び出されたときに関数に渡された値を常に反映します (これは、渡される変数の型に関係なく、すべての厳格モードの関数の場合と同じ動作です)。

+ +
function func(a = 55) {
+  arguments[0] = 99; // arguments[0] を更新しても a は更新されない
+  console.log(a);
+}
+func(10); // 10
+ +

および

+ +
function func(a = 55) {
+  a = 99; // a を更新しても arguments[0] は更新されない
+  console.log(arguments[0]);
+}
+func(10); // 10
+
+ +

および

+ +
// デフォルト引数は追跡されません。
+function func(a = 55) {
+  console.log(arguments[0]);
+}
+func(); // undefined
+ +

仕様書

+ + + + + + + + + + + + +
仕様書
{{SpecName('ESDraft', '#sec-arguments-exotic-objects', 'Arguments Exotic Objects')}}
+ +

ブラウザーの互換性

+ + + +

{{Compat("javascript.functions.arguments")}}

+ +

関連情報

+ + diff --git a/files/ja/web/javascript/reference/functions/arguments/length/index.html b/files/ja/web/javascript/reference/functions/arguments/length/index.html new file mode 100644 index 0000000000..cc8781a8c6 --- /dev/null +++ b/files/ja/web/javascript/reference/functions/arguments/length/index.html @@ -0,0 +1,124 @@ +--- +title: arguments.length +slug: Web/JavaScript/Reference/Functions/arguments/length +tags: + - arguments +translation_of: Web/JavaScript/Reference/Functions/arguments/length +--- +
{{jsSidebar("Functions")}}
+ +

arguments.length プロパティは、関数に渡された引数の数を含みます。

+ +

構文

+ +
arguments.length
+ +

説明

+ +

The arguments.length プロパティは、実際に関数に渡された引数の数を提供します。これは、定義されたパラメーターの数以上にも以下にもできます({{jsxref("Function.length")}} を見てください)。

+ +

+ +

arguments.length を使用する

+ +

この例では、2 つ以上の数を加算する関数を定義しています。

+ +
function adder(base /*, n2, ... */) {
+  base = Number(base);
+  for (var i = 1; i < arguments.length; i++) {
+    base += Number(arguments[i]);
+  }
+  return base;
+}
+
+ +

仕様

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
仕様ステータスコメント
{{SpecName('ES1')}}{{Spec2('ES1')}}初期定義。JavaScript 1.1 で実装。
{{SpecName('ES5.1', '#sec-10.6', 'Arguments Object')}}{{Spec2('ES5.1')}} 
{{SpecName('ES6', '#sec-arguments-exotic-objects', 'Arguments Exotic Objects')}}{{Spec2('ES6')}} 
{{SpecName('ESDraft', '#sec-arguments-exotic-objects', 'Arguments Exotic Objects')}}{{Spec2('ESDraft')}} 
+ +

ブラウザ実装状況

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + +
機能ChromeFirefox (Gecko)Internet ExplorerOperaSafari
基本サポート{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + +
機能AndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
基本サポート{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
+
+ +

関連項目

+ + -- cgit v1.2.3-54-g00ecf