diff options
author | allo <yin199909@aliyun.com> | 2022-01-23 21:26:35 +0800 |
---|---|---|
committer | Irvin <irvinfly@gmail.com> | 2022-02-15 22:29:19 +0800 |
commit | c1ed2f39d8921536444e3334bab549d7100a286e (patch) | |
tree | 958c1e36842321f25b1fb01977c9ef05ca303ff5 | |
parent | 987e2e8a8081eabe635e601958e19ed9d96b0483 (diff) | |
download | translated-content-c1ed2f39d8921536444e3334bab549d7100a286e.tar.gz translated-content-c1ed2f39d8921536444e3334bab549d7100a286e.tar.bz2 translated-content-c1ed2f39d8921536444e3334bab549d7100a286e.zip |
sync with english version for JavaScript/Function
-rw-r--r-- | files/zh-cn/web/javascript/reference/global_objects/function/index.md | 171 |
1 files changed, 52 insertions, 119 deletions
diff --git a/files/zh-cn/web/javascript/reference/global_objects/function/index.md b/files/zh-cn/web/javascript/reference/global_objects/function/index.md index 5358d39627..ed00e05dd6 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/function/index.md +++ b/files/zh-cn/web/javascript/reference/global_objects/function/index.md @@ -2,87 +2,52 @@ title: Function slug: Web/JavaScript/Reference/Global_Objects/Function tags: - - Constructor + - Class - Function - JavaScript - - 函数 - - 构造器 translation_of: Web/JavaScript/Reference/Global_Objects/Function --- -<div>{{JSRef}}</div> +{{JSRef}} -<div>每个 JavaScript 函数实际上都是一个 <code>Function</code> 对象。运行 <code>(function(){}).constructor === Function // true</code> 便可以得到这个结论。</div> +每个 JavaScript 函数实际上都是一个 `Function` 对象。运行 `(function(){}).constructor === Function // true` 便可以得到这个结论。 -<h2 id="构造函数">构造函数</h2> +## 构造函数 -<p><strong><code>Function</code> 构造函数</strong>创建一个新的 <code>Function</code> <strong>对象</strong>。直接调用此构造函数可用动态创建函数,但会遇到和 {{jsxref("eval")}} 类似的的安全问题和(相对较小的)性能问题。然而,与 <code>eval</code> 不同的是,<code>Function</code> 创建的函数只能在全局作用域中运行。</p> +- {{jsxref("Function.Function", "Function()")}} + - : 创建一个新的 `Function` 对象。直接调用此构造函数可以动态创建函数,但会遇到和 {{jsxref("Global_Objects/eval", "eval()")}} 类似的的安全问题和(相对较小的)性能问题。然而,与 `eval()` 不同的是,`Function` 构造函数创建的函数只能在全局作用域中运行。 -<div>{{EmbedInteractiveExample("pages/js/function-constructor.html")}}</div> +## 实例属性 +- {{jsxref("Function.prototype.arguments")}} {{Deprecated_Inline}} + - : 对应传递给函数的参数数组,这个 {{jsxref("Function")}} 的属性已被弃用,请改用 {{jsxref("Functions/arguments", "arguments")}} 对象(仅在函数范围内可用)。 +- {{jsxref("Function.prototype.caller")}} {{Deprecated_Inline}} + - : 表明调用当前函数执行的函数,此属性已被弃用,且仅对一些不严格的函数可用。 +- {{jsxref("Function.prototype.displayName")}} + - : 函数的显示名称。 +- {{jsxref("Function.prototype.length")}} + - : 函数期望的参数数量。 +- {{jsxref("Function.prototype.name")}} + - : 函数的名称。 +## 实例方法 -<h2 id="语法">语法</h2> +- {{jsxref("Function.prototype.apply()", "Function.prototype.apply(<var>thisArg</var> [, <var>argsArray</var>])")}} + - : 调用一个函数并将其 `this` 的值设置为提供的 `thisArg`。参数可用以通过{{jsxref("Array", "数组")}}对象传递。 +- {{jsxref("Function.prototype.bind()", "Function.prototype.bind(<var>thisArg</var>[, <var>arg1</var>[, <var>arg2</var>[, ...<var>argN</var>]]])")}} + - : 创建一个新的函数,该函数在调用时,会将 `this` 设置为提供的 `thisArg`。在调用新绑定的函数时,可选的参数序列(`[, arg1[, arg2[, ...argN]]]`)会被提前添加到参数序列中(译者注:即调用绑定创建的函数时,传递的参数会接续在可选参数序列后)。 +- {{jsxref("Function.prototype.call()", "Function.prototype.call(<var>thisArg</var>[, <var>arg1</var>, <var>arg2</var>, ...<var>argN</var>])")}} + - : 调用一个函数,并将其 `this` 值设置为提供的值。也可以选择传输新参数。 +- {{jsxref("Function.prototype.toString()", "Function.prototype.toString()")}} + - : 返回表示函数源码的字符串。覆盖了 {{jsxref("Object.prototype.toString")}} 方法。 -<pre class="syntaxbox"><code>new Function ([<var>arg1</var>[, <var>arg2</var>[, ...<var>argN</var>]],] <var>functionBody</var>)</code></pre> +## 示例 -<h3 id="参数">参数</h3> +### Function 构造函数与函数声明之间的不同 -<dl> - <dt><code>arg1, arg2, ... arg<em>N</em></code></dt> - <dd>被函数使用的参数的名称必须是合法命名的。参数名称是一个有效的JavaScript标识符的字符串,或者一个用逗号分隔的有效字符串的列表;例如“<code>×</code>”,“<code>theValue</code>”,或“<code>a,b</code>”。</dd> - <dt><code>functionBody</code></dt> - <dd>一个含有包括函数定义的 JavaScript 语句的<strong>字符串</strong>。</dd> -</dl> +由 `Function` 构造函数创建的函数不会创建当前环境的闭包,它们总是被创建于全局环境,因此在运行时它们只能访问全局变量和自己的局部变量,不能访问它们被 `Function` 构造函数创建时所在的作用域的变量。这一点与使用 {{jsxref("Global_Objects/eval", "eval()")}} 执行创建函数的代码不同。 -<h2 id="描述">描述</h2> - -<p>使用 <code>Function</code> 构造器生成的 <code>Function</code> 对象是在函数创建时解析的。这比你使用<a href="/zh-CN/docs/Web/JavaScript/Reference/Operators/function">函数声明</a>或者<a href="/zh-CN/docs/Web/JavaScript/Reference/Operators/function">函数表达式</a>并在你的代码中调用更为低效,因为使用后者创建的函数是跟其他代码一起解析的。</p> - -<p>所有被传递到构造函数中的参数,都将被视为将被创建的函数的参数,并且是相同的标示符名称和传递顺序。<a href="/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/eval"><span class="hidden"> </span></a></p> - -<p>以调用函数的方式调用 <code>Function</code> 的构造函数(而不是使用 <code>new</code> 关键字) 跟以构造函数来调用是一样的。</p> - -<h2 id="属性和方法">属性和方法</h2> - -<p>全局的 <code>Function</code> 对象没有自己的属性和方法,但是,因为它本身也是一个函数,所以它也会通过原型链从自己的原型链 {{jsxref("Function.prototype")}} 上继承一些属性和方法。</p> - -<h2 id="原型对象">原型对象</h2> - -<h3 id="属性">属性</h3> - -<div>{{page('/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Function/prototype', '属性')}}</div> - -<h3 id="方法">方法</h3> - -<div>{{page('/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Function/prototype', '方法')}}</div> - -<h2 id="实例">实例</h2> - -<p><code>Function</code> 实例从 {{jsxref("Function.prototype")}} 继承了一些属性和方法。 同其他构造函数一样, 你可以改变构造函数的原型从而使得所有的 <code>Function</code> 实例的属性和方法发生改变。</p> - -<h2 id="示例">示例</h2> - -<h3 id="传入参数调用_Function_构造函数">传入参数调用 Function 构造函数</h3> - -<p>下面的代码会创建一个需要两个参数的 <code>Function</code> 对象。</p> - -<pre class="brush: js">// 可以直接在 JavaScript 控制台中运行 - -// 创建了一个能返回两个参数和的函数 -const adder = new Function("a", "b", "return a + b"); - -// 调用函数 -adder(2, 6); -// > 8 -</pre> - -<p>参数 "<code>a</code>" 和 "<code>b</code>" 是参数的名字,在函数体中被使用,"<code>return a + b</code>"。</p> - -<h3 id="Function_构造器与函数声明之间的不同">Function 构造器与函数声明之间的不同</h3> - -<p>由 <code>Function</code> 构造器创建的函数不会创建当前环境的闭包,它们总是被创建于全局环境,因此在运行时它们只能访问全局变量和自己的局部变量,不能访问它们被 <code>Function</code> 构造器创建时所在的作用域的变量。这一点与使用 {{jsxref("eval")}} 执行创建函数的代码不同。</p> - -<pre class="brush: js">var x = 10; +```js +var x = 10; function createFunction1() { var x = 20; @@ -101,56 +66,24 @@ var f1 = createFunction1(); console.log(f1()); // 10 var f2 = createFunction2(); console.log(f2()); // 20 -</pre> - -<p>虽然这段代码可以在浏览器中正常运行,但在 Node.js 中 <code>f1()</code> 会产生一个“找不到变量 <code>x</code> ”的 <code>ReferenceError</code>。这是因为在 Node 中顶级作用域不是全局作用域,而 <code>x</code> 其实是在当前模块的作用域之中。</p> - -<h2 id="规范">规范</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - <tr> - <td>{{SpecName('ES1')}}</td> - <td>{{Spec2('ES1')}}</td> - <td>Initial definition. Implemented in JavaScript 1.0.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.3', 'Function')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td></td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-function-objects', 'Function')}}</td> - <td>{{Spec2('ES6')}}</td> - <td></td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-function-objects', 'Function')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td></td> - </tr> - </tbody> -</table> - -<h2 id="浏览器兼容性">浏览器兼容性</h2> - - - -<p>{{Compat("javascript.builtins.Function")}}</p> - -<h2 id="相关链接">相关链接</h2> - -<ul> - <li>{{jsxref("Functions", "函数与函数作用域")}}</li> - <li>{{jsxref("Statements/function", "函数声明")}}</li> - <li>{{jsxref("Operators/function", "函数表达式")}}</li> - <li>{{jsxref("Statements/function*", "function* 声明")}}</li> - <li>{{jsxref("Operators/function*", "function* 表达式")}}</li> - <li>{{jsxref("AsyncFunction")}}</li> - <li>{{jsxref("GeneratorFunction")}}</li> -</ul> +``` + +虽然这段代码可以在浏览器中正常运行,但在 Node.js 中 `f1()` 会产生一个“找不到变量 `x`”的 `ReferenceError`。这是因为在 Node 中顶级作用域不是全局作用域,而 `x` 其实是在当前模块的作用域之中。 + +## 规范 + +{{Specifications}} + +## 浏览器兼容性 + +{{Compat}} + +## 参见 + +- {{jsxref("Functions", "函数与函数作用域")}} +- {{jsxref("Statements/function", "函数声明")}} +- {{jsxref("Operators/function", "函数表达式")}} +- {{jsxref("Statements/function*", "function* 声明")}} +- {{jsxref("Operators/function*", "function* 表达式")}} +- {{jsxref("AsyncFunction", "异步函数")}} +- {{jsxref("GeneratorFunction", "生成器函数")}} |