From c1ed2f39d8921536444e3334bab549d7100a286e Mon Sep 17 00:00:00 2001 From: allo Date: Sun, 23 Jan 2022 21:26:35 +0800 Subject: sync with english version for JavaScript/Function --- .../reference/global_objects/function/index.md | 171 +++++++-------------- 1 file changed, 52 insertions(+), 119 deletions(-) (limited to 'files/zh-cn/web/javascript/reference/global_objects/function') 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 --- -
{{JSRef}}
+{{JSRef}} -
每个 JavaScript 函数实际上都是一个 Function 对象。运行 (function(){}).constructor === Function // true 便可以得到这个结论。
+每个 JavaScript 函数实际上都是一个 `Function` 对象。运行 `(function(){}).constructor === Function // true` 便可以得到这个结论。 -

构造函数

+## 构造函数 -

Function 构造函数创建一个新的 Function 对象。直接调用此构造函数可用动态创建函数,但会遇到和 {{jsxref("eval")}} 类似的的安全问题和(相对较小的)性能问题。然而,与 eval 不同的是,Function 创建的函数只能在全局作用域中运行。

+- {{jsxref("Function.Function", "Function()")}} + - : 创建一个新的 `Function` 对象。直接调用此构造函数可以动态创建函数,但会遇到和 {{jsxref("Global_Objects/eval", "eval()")}} 类似的的安全问题和(相对较小的)性能问题。然而,与 `eval()` 不同的是,`Function` 构造函数创建的函数只能在全局作用域中运行。 -
{{EmbedInteractiveExample("pages/js/function-constructor.html")}}
+## 实例属性 +- {{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")}} + - : 函数的名称。 +## 实例方法 -

语法

+- {{jsxref("Function.prototype.apply()", "Function.prototype.apply(thisArg [, argsArray])")}} + - : 调用一个函数并将其 `this` 的值设置为提供的 `thisArg`。参数可用以通过{{jsxref("Array", "数组")}}对象传递。 +- {{jsxref("Function.prototype.bind()", "Function.prototype.bind(thisArg[, arg1[, arg2[, ...argN]]])")}} + - : 创建一个新的函数,该函数在调用时,会将 `this` 设置为提供的 `thisArg`。在调用新绑定的函数时,可选的参数序列(`[, arg1[, arg2[, ...argN]]]`)会被提前添加到参数序列中(译者注:即调用绑定创建的函数时,传递的参数会接续在可选参数序列后)。 +- {{jsxref("Function.prototype.call()", "Function.prototype.call(thisArg[, arg1, arg2, ...argN])")}} + - : 调用一个函数,并将其 `this` 值设置为提供的值。也可以选择传输新参数。 +- {{jsxref("Function.prototype.toString()", "Function.prototype.toString()")}} + - : 返回表示函数源码的字符串。覆盖了 {{jsxref("Object.prototype.toString")}} 方法。 -
new Function ([arg1[, arg2[, ...argN]],] functionBody)
+## 示例 -

参数

+### Function 构造函数与函数声明之间的不同 -
-
arg1, arg2, ... argN
-
被函数使用的参数的名称必须是合法命名的。参数名称是一个有效的JavaScript标识符的字符串,或者一个用逗号分隔的有效字符串的列表;例如“×”,“theValue”,或“a,b”。
-
functionBody
-
一个含有包括函数定义的 JavaScript 语句的字符串
-
+由 `Function` 构造函数创建的函数不会创建当前环境的闭包,它们总是被创建于全局环境,因此在运行时它们只能访问全局变量和自己的局部变量,不能访问它们被 `Function` 构造函数创建时所在的作用域的变量。这一点与使用 {{jsxref("Global_Objects/eval", "eval()")}} 执行创建函数的代码不同。 -

描述

- -

使用 Function 构造器生成的 Function 对象是在函数创建时解析的。这比你使用函数声明或者函数表达式并在你的代码中调用更为低效,因为使用后者创建的函数是跟其他代码一起解析的。

- -

所有被传递到构造函数中的参数,都将被视为将被创建的函数的参数,并且是相同的标示符名称和传递顺序。

- -

以调用函数的方式调用 Function 的构造函数(而不是使用 new 关键字) 跟以构造函数来调用是一样的。

- -

属性和方法

- -

全局的 Function 对象没有自己的属性和方法,但是,因为它本身也是一个函数,所以它也会通过原型链从自己的原型链 {{jsxref("Function.prototype")}} 上继承一些属性和方法。

- -

原型对象

- -

属性

- -
{{page('/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Function/prototype', '属性')}}
- -

方法

- -
{{page('/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Function/prototype', '方法')}}
- -

实例

- -

Function 实例从 {{jsxref("Function.prototype")}} 继承了一些属性和方法。 同其他构造函数一样, 你可以改变构造函数的原型从而使得所有的 Function 实例的属性和方法发生改变。

- -

示例

- -

传入参数调用 Function 构造函数

- -

下面的代码会创建一个需要两个参数的 Function 对象。

- -
// 可以直接在 JavaScript 控制台中运行
-
-// 创建了一个能返回两个参数和的函数
-const adder = new Function("a", "b", "return a + b");
-
-// 调用函数
-adder(2, 6);
-// > 8
-
- -

参数 "a" 和 "b" 是参数的名字,在函数体中被使用,"return a + b"。

- -

Function 构造器与函数声明之间的不同

- -

由 Function 构造器创建的函数不会创建当前环境的闭包,它们总是被创建于全局环境,因此在运行时它们只能访问全局变量和自己的局部变量,不能访问它们被 Function 构造器创建时所在的作用域的变量。这一点与使用 {{jsxref("eval")}} 执行创建函数的代码不同。

- -
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
-
- -

虽然这段代码可以在浏览器中正常运行,但在 Node.js 中 f1() 会产生一个“找不到变量 x ”的 ReferenceError。这是因为在 Node 中顶级作用域不是全局作用域,而 x 其实是在当前模块的作用域之中。

- -

规范

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName('ES1')}}{{Spec2('ES1')}}Initial definition. Implemented in JavaScript 1.0.
{{SpecName('ES5.1', '#sec-15.3', 'Function')}}{{Spec2('ES5.1')}}
{{SpecName('ES6', '#sec-function-objects', 'Function')}}{{Spec2('ES6')}}
{{SpecName('ESDraft', '#sec-function-objects', 'Function')}}{{Spec2('ESDraft')}}
- -

浏览器兼容性

- - - -

{{Compat("javascript.builtins.Function")}}

- -

相关链接

- - +``` + +虽然这段代码可以在浏览器中正常运行,但在 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", "生成器函数")}} -- cgit v1.2.3-54-g00ecf