一般来说，一个函数是可以通过外部代码调用的一个“子程序”（或在递归的情况下由内部函数调用）。像程序本身一样，一个函数由称为函数体的一系列语句组成。值可以传递给一个函数，函数将返回一个值。
在 JavaScript中，函数是头等(first-class)对象，因为它们可以像任何其他对象一样具有属性和方法。它们与其他对象的区别在于函数可以被调用。简而言之，它们是`Function`对象。

有关更多示例和说明，请参阅有关函数的JavaScript指南。

## 描述

在JavaScript中，每个函数其实都是一个`Function`对象。查看`Function`页面`了解其`属性和方法。

如果一个函数中没有使用return语句，则它默认返回`undefined`。要想返回一个特定的值，则函数必须使用 `return` 语句来指定一个要返回的值。(使用new关键字调用一个构造函数除外)。

调用函数时，传递给函数的值被称为函数的实参（值传递），对应位置的函数参数名叫作形参。如果实参是一个包含原始值(数字，字符串，布尔值)的变量，则就算函数在内部改变了对应形参的值，返回后，该实参变量的值也不会改变。如果实参是一个对象引用，则对应形参会和该实参指向同一个对象。假如函数在内部改变了对应形参的值，返回后，实参指向的对象的值也会改变：

     /* 定义函数 myFunc */
     function myFunc(theObject)
     {
       //实参 mycar 和形参 theObject 指向同一个对象.
       theObject.brand = "Toyota";
     }

     /*
      * 定义变量 mycar;
      * 创建并初始化一个对象;
      * 将对象的引用赋值给变量 mycar
      */
     var mycar = {
       brand: "Honda",
       model: "Accord",
       year: 1998
     };

     /* 弹出 'Honda' */
     window.alert(mycar.brand);

     /* 将对象引用传给函数 */
     myFunc(mycar);

     /*
      * 弹出 'Toyota',对象的属性已被修改.
      */
     console.log(mycar.brand);

在函数执行时，`this` 关键字并不会指向正在运行的函数本身，而是指向调用该函数的对象。所以，如果你想在函数内部获取函数自身的引用，只能使用函数名或者使用arguments.callee属性(严格模式下不可用)，如果该函数是一个匿名函数,则你只能使用后者。

## 函数定义

定义函数有多种方法:

### 函数声明 (函数语句)

有一个特殊的语法来声明函数(查看函数语句了解详情)：

    function name([param[, param[, ... param]]]) { statements }

`name`
  函数名.

`param`
  传递给函数的参数的名称，一个函数最多可以有255个参数。

`statements`
  组成函数体的声明语句。

### 函数表达式 (`function` expression)

函数表达式和函数声明非常相似，它们甚至有相同的语法（查看函数表达式了解详情）。一个函数表达式可能是一个更大的表达式的一部分。可以定义函数“名字”（例如可以在调用堆栈时使用）或者使用“匿名”函数。函数表达式不会提升，所以不能在定义之前调用。

    var myFunction = function name([param[, param[, ... param]]]) { statements }

`name`
  函数名，可以省略。当省略函数名的时候，该函数就成为了匿名函数。

`param`
  传递给函数的参数的名称，一个函数最多可以有255个参数.

`statements`
  组成函数体的声明语句。

下面是匿名函数的一个例子（函数没有名字）：

    var myFunction = function() {
        // statements
    }

也可以在定义时为函数命名：

    var myFunction = function namedFunction(){
        // statements
    }

命名函数表达式的好处是当我们遇到错误时，堆栈跟踪会显示函数名，容易寻找错误。

可以看到，上面的两个例子都不以function开头。不以function开头的函数语句就是函数表达式定义。

当函数只使用一次时，通常使用IIFE (Immediately Invokable Function Expressions)。

    (function() {
        statements
    })();

IIFE是在函数声明后立即调用的函数表达式。

### 函数生成器声明 (`function*` 语句)

函数声明有一种特殊的语法 (详情请查阅`function* statement` )：

    function* name([param[, param[, ...param]]]) { statements }

`name`
  函数名称.
`param`
  传递给函数的参数的名称，一个函数最多可以有255个参数。
`statements`
  组成函数体的声明语句。

### 函数生成器表达式 (`function*`表达式)

构造函数表达式和函数声明类似，并且有着相同的语法 (详情请查阅 `function* expression` ):

    function* [name]([param] [, param] [..., param]) { statements }

`name`
  函数名称。函数名可以被省略，在这种情况下该函数将变成匿名函数。
`param`
  传递给函数的参数的名称。一个函数可以有多达255个参数
`statements`
  组成函数体的声明语句。

### 箭头函数表达式 (=>)

箭头函数表达式有着更短的语法，并在词汇方面结合这个值 (详情请查阅 arrow functions ):

    ([param] [, param]) => { statements } param => expression

`param`
  参数名称. 零参数需要用()表示. 只有一个参数时不需要括号. (例如 `foo => 1`)
`statements or expression`
  多个声明statements需要用大括号括起来，而单个表达式时则不需要。表达式expression也是该函数的隐式返回值。

### `Function`构造函数

注意: 不推荐使用 `Function` 构造函数创建函数,因为它需要的函数体作为字符串可能会阻止一些JS引擎优化,也会引起其他问题。

所有其他对象, `Function` 对象可以用new操作符创建:

    new Function (arg1, arg2, ... argN, functionBody)

`arg1, arg2, ... argN`
  函数使用零个或多个名称作为正式的参数名称。每一个必须是一个符合有效的JavaScript标识符规则的字符串或用逗号分隔的字符串列表,例如“x”,“theValue”或“a,b”。

`functionBody`
  一个构成的函数定义的，包含JavaScript声明语句的字符串。

把Function的构造函数当作函数一样调用(不使用new操作符)的效果与作为Function的构造函数调用一样。

### 生成器函数的构造函数

注意: `GeneratorFunction` 不是一个全局对象，但可以从构造函数实例取得。(详情请查阅生成器函数).

注意: 不推荐使用构造器函数的构造函数 (`GeneratorFunction` constructor)创建函数，因为它需要的函数体作为字符串可能会阻止一些JS引擎优化，也会引起其他问题。

所有其他对象, `GeneratorFunction` 对象可以用 new 操作符创建：

    new GeneratorFunction (arg1, arg2, ... argN, functionBody)

`arg1, arg2, ... argN`
  函数使用零个或多个名称作为正式的参数名称。每一个必须是一个符合有效的JavaScript标识符规则的字符串或用逗号分隔的字符串列表,例如“x”,“theValue”或“a,b”。

`functionBody`
  一个构成的函数定义的，包含JavaScript声明语句的字符串。

把Function的构造函数当作函数一样调用(不使用new操作符)的效果与作为Function的构造函数调用一样。

## 函数参数

### 默认参数

如果没有值或传入了未定义的值，默认函数参数允许形式参数使用默认值初始化。 参见：默认参数。

### 剩余参数

剩余参数语法允许将数量不限的参数描述成一个数组。 参见：剩余参数。

## `arguments`对象

你可以参阅在函数里使用`arguments`对象的函数参数。参见： arguments。

- `arguments`: 一个包含了传递给当前执行函数参数的类似于数组的对象。
- `arguments.callee` : 当前正在执行的函数。
- `arguments.caller` : 调用当前执行函数的函数。
- `arguments.length`: 传给函数的参数的数目。

## 方法函数定义

### Getter 和 setter 函数

你可以在支持添加新属性的任何标准的内置对象或用户定义的对象内定义getter(访问方法)和setter(设置方法)。使用对象字面量语法定义getters和setters方法。

get

  当查找某个对象属性时，该对象属性将会与被调用函数绑定。

set
  当试图设置该属性时，对象属性与被调用函数绑定。

### 方法定义语法

从ECMAScript 6开始, 你可以用更短的语法定义自己的方法，类似于getters和setters。详情请查阅 method definitions .

     var obj = {
       foo() {},
       bar() {}
     };

## 构造函数 vs 函数声明 vs 函数表达式

对比下面的例子：

一个用`Function`构造函数定义的函数,被赋值给变量multiply：

    var multiply = new Function('x', 'y', 'return x * y');

一个名为`multiply`的函数声明：

    function multiply(x, y) {
       return x * y;
    } // 没有分号

一个匿名函数的函数表达式，被赋值给变量`multiply`：

     var multiply = function(x, y) {
       return x * y;
     };

一个命名为`func_named`的函数的函数表达式，被赋值给变量 `multiply`：

    var multiply = function func_name(x, y) {
       return x * y;
    };

### 差别

虽然有一些细微的差别，但所起的作用都差不多：

函数名和函数的变量存在着差别。函数名不能被改变，但函数的变量却能够被再分配。函数名只能在函数体内使用。倘若在函数体外使用函数名将会导致错误（如果函数之前是通过一个var语句声明的则是undefined）。例如：

    var y = function x() {};
    alert(x); // throws an error

当函数是通过 `Function`'s toString method被序列化时，函数名同样也会出现。

另一方面，被函数赋值的变量仅仅受限于它的作用域，该作用域确保包含着该函数被声明时的作用域。

正如第四个例子所展示的那样，函数名与被函数赋值的变量是不相同的. 彼此之间没有关系。函数声明同时也创建了一个和函数名相同的变量。因此，与函数表达式定义不同，以函数声明定义的函数能够在它们被定义的作用域内通过函数名而被访问到：

使用用 '`new Function'定义的函数没有函数名。` 然而，在 SpiderMonkey JavaScript引擎中，其函数的序列化形式表现的好像它拥有一个名叫"anonymous"的名称一样。比如，使用 `alert(new Function())` 输出：

    function anonymous() {
    }

而实际上其函数并没有名称，`anonymous` 不是一个可以在函数内被访问到的变量。例如，下面的例子将会导致错误：

    var foo = new Function("alert(anonymous);");
    foo();

和通过函数表达式定义或者通过Function构造函数定义的函数不同，函数声明定义的函数可以在它被声明之前使用。举个例子：

    foo(); // alerts FOO!
    function foo() {
       alert('FOO!');
    }

函数表达式定义的函数继承了当前的作用域。换言之，函数构成了闭包。另一方面，Function构造函数定义的函数不继承任何全局作用域以外的作用域(那些所有函数都继承的)。

通过函数表达式定义的函数和通过函数声明定义的函数只会被解析一次，而Function构造函数定义的函数却不同。也就是说，每次构造函数被调用，传递给Function构造函数的函数体字符串都要被解析一次 。虽然函数表达式每次都创建了一个闭包，但函数体不会被重复解析，因此函数表达式仍然要快于"`new Function(...)`"。 所以Function构造函数应尽可能地避免使用。

有一点应该要注意的，在通过解析Function构造函数字符串产生的函数里，内嵌的函数表达式和函数声明不会被重复解析。例如：

    var foo = (new Function("var bar = \'FOO!\';\nreturn(function() {\n\talert(bar);\n});"))();
    foo(); // 函数体字符串"function() {\n\talert(bar);\n}"的这一部分不会被重复解析。

函数声明非常容易（经常是意外地）转换为函数表达式。当它不再是一个函数声明：

- 成为表达式的一部分
- 不再是函数或者脚本自身的“源元素” （source element）。“源元素”是脚本或函数体中的非嵌套语句。

    var x = 0;               // source element
    if (x === 0) {           // source element
       x = 10;               // 非source element
       function boo() {}     // 非 source element
    }
    function foo() {         // source element
       var y = 20;           // source element
       function bar() {}     // source element
       while (y === 10) {    // source element
          function blah() {} // 非 source element
          y++;               //非source element
       }
    }

### 例子

    // 函数声明
    function foo() {}

    // 函数表达式
    (function bar() {})

    // 函数表达式
    x = function hello() {}

    if (x) {
       // 函数表达式
       function world() {}
    }

    // 函数声明
    function a() {
       // 函数声明
       function b() {}
       if (0) {
          //函数表达式
          function c() {}
       }
    }

## 块级函数

从ECMAScript 6开始，在严格模式下，块里的函数作用域为这个块。ECMAScript 6之前不建议块级函数在严格模式下使用。

    'use strict';

    function f() {
      return 1;
    }

    {
      function f() {
        return 2;
      }
    }

    f() === 1; // true

    // f() === 2 in non-strict mode

### 非严格模式下的块级函数

一句话：不要用。

在非严格模式下，块中的函数声明表现奇怪。例如：

    if (shouldDefineZero) {
       function zero() {     // DANGER: 兼容性风险
          console.log("This is zero.");
       }
    }

ECMAScript 6中，如果`shouldDefineZero`是false，则永远不会定义zero,因为这个块从不执行。然而，这是标准的新的一部分。这是历史遗留问题，无论这个块是否执行，一些浏览器会定义zero。

`在`严格模式`下，所有支持`ECMAScript 6的`浏览器以相同的方式处理：只有在shouldDefineZero为true的情况下定义zero，并且作用域只是这个块内。`

有条件地定义一个函数的一个更安全的方法是把函数表达式赋给一个变量：

    var zero;
    if (0) {
       zero = function() {
          console.log("This is zero.");
       };
    }

## 示例

### 返回格式化数字

下面的函数返回一个字符串，其中包含了一个格式化的、以一个由0开头并填充的数字。

    // 这个函数返回一个由0开头并填充的字符串
    function padZeros(num, totalLen) {
       var numStr = num.toString();             // 用字符串返回值进行初始化
       var numZeros = totalLen - numStr.length; // 计算zeros顺序
       for (var i = 1; i <= numZeros; i++) {
          numStr = "0" + numStr;
       }
       return numStr;
    }

下面的语句调用了padZeros函数：

    var result;
    result = padZeros(42,4); // returns "0042"
    result = padZeros(42,2); // returns "42"
    result = padZeros(5,4);  // returns "0005"

### 检测函数是否存在

你可以通过 typeof 操作符检测一个函数是否存在。在下面的例子中，用一个测试来演示检测window对象是否拥有一个noFunc函数的属性。如果存在，那就使用它；否则就采取其它的一些操作。

    if ('function' === typeof window.noFunc) {
       // use noFunc()
     } else {
       // do something else
     }

注意在if语句中，使用了noFunc的引用--在函数名的后面没有括号“（）”，所以实际函数并没有被调用。

## 规范

Specification | Status | Comment
--- | --- | ---
ECMAScript 1st Edition (ECMA-262) | Standard | Initial definition. Implemented in JavaScript 1.0
ECMAScript 5.1 (ECMA-262) Function Definition | Standard |
ECMAScript 2015 (6th Edition, ECMA-262) Function definitions | Standard | New: Arrow functions, Generator functions, default parameters, rest parameters.
ECMAScript Latest Draft (ECMA-262) Function definitions | Draft |

## 浏览器兼容

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

Update compatibility data on GitHub

| Desktop | Mobile | Server
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | Android webview | Chrome for Android | Edge Mobile | Firefox for Android | Opera for Android | Safari on iOS | Samsung Internet | Node.js
`functions` | Chrome Full support Yes | Edge Full support Yes | Firefox Full support 1 | IE Full support Yes | Opera Full support Yes | Safari Full support Yes | WebView Android Full support Yes | Chrome Android Full support Yes | Edge Mobile Full support Yes | Firefox Android Full support 4 | Opera Android Full support Yes | Safari iOS Full support Yes | Samsung Internet Android Full support Yes | nodejs Full support Yes
`arguments` | Chrome Full support Yes | Edge Full support Yes | Firefox Full support 1 | IE Full support Yes | Opera Full support Yes | Safari Full support Yes | WebView Android Full support Yes | Chrome Android Full support Yes | Edge Mobile Full support Yes | Firefox Android Full support 4 | Opera Android Full support Yes | Safari iOS Full support Yes | Samsung Internet Android Full support Yes | nodejs Full support Yes
Arrow functions | Chrome Full support 45 | Edge Full support Yes | Firefox Full support 22 Notes Full support 22 Notes Notes The initial implementation of arrow functions in Firefox made them automatically strict. This has been changed as of Firefox 24. The use of `'use strict';` is now required. Notes Prior to Firefox 39, a line terminator (`\n`) was incorrectly allowed after arrow function arguments. This has been fixed to conform to the ES2015 specification and code like `() \n => {}` will now throw a `SyntaxError` in this and later versions. | IE No support No | Opera Full support 32 | Safari Full support 10 | WebView Android Full support 45 | Chrome Android Full support 45 | Edge Mobile Full support Yes | Firefox Android Full support 22 Notes Full support 22 Notes Notes The initial implementation of arrow functions in Firefox made them automatically strict. This has been changed as of Firefox 24. The use of `'use strict';` is now required. Notes Prior to Firefox 39, a line terminator (`\n`) was incorrectly allowed after arrow function arguments. This has been fixed to conform to the ES2015 specification and code like `() \n => {}` will now throw a `SyntaxError` in this and later versions. | Opera Android Full support 32 | Safari iOS Full support 10 | Samsung Internet Android Full support 5.0 | nodejs Full support Yes
Block-level functions | Chrome ? | Edge ? | Firefox Full support 46 | IE ? | Opera ? | Safari ? | WebView Android ? | Chrome Android ? | Edge Mobile ? | Firefox Android Full support 46 | Opera Android ? | Safari iOS ? | Samsung Internet Android ? | nodejs ?
Default parameters | Chrome Full support 49 | Edge Full support 14 | Firefox Full support 15 | IE No support No | Opera Full support 36 | Safari Full support 10 | WebView Android Full support 49 | Chrome Android Full support 49 | Edge Mobile Full support 14 | Firefox Android Full support 15 | Opera Android Full support 36 | Safari iOS Full support 10 | Samsung Internet Android Full support 5.0 | nodejs Full support 6.0.0
Method definitions | Chrome Full support 39 | Edge Full support Yes | Firefox Full support 34 | IE No support No | Opera Full support 26 | Safari No support No | WebView Android Full support 39 | Chrome Android Full support 39 | Edge Mobile Full support Yes | Firefox Android Full support 34 | Opera Android Full support 26 | Safari iOS No support No | Samsung Internet Android Full support 4.0 | nodejs Full support Yes
Rest parameters | Chrome Full support 47 | Edge Full support 12 | Firefox Full support 15 | IE No support No | Opera Full support 34 | Safari Full support 10 | WebView Android Full support 47 | Chrome Android Full support 47 | Edge Mobile Full support 12 | Firefox Android Full support 15 | Opera Android Full support 34 | Safari iOS Full support 10 | Samsung Internet Android Full support 5.0 | nodejs Full support 6.0.0 Full support 6.0.0 Full support 4.0.0 Disabled Disabled From version 4.0.0: this feature is behind the `--harmony` runtime flag.
`get` | Chrome Full support 1 | Edge Full support Yes | Firefox Full support 2 | IE Full support 9 | Opera Full support 9.5 | Safari Full support 3 | WebView Android Full support 1 | Chrome Android Full support 18 | Edge Mobile Full support Yes | Firefox Android Full support 4 | Opera Android Full support Yes | Safari iOS Full support Yes | Samsung Internet Android Full support Yes | nodejs Full support Yes
`set` | Chrome Full support 1 | Edge Full support Yes | Firefox Full support 2 | IE Full support 9 | Opera Full support 9.5 | Safari Full support 3 | WebView Android Full support 1 | Chrome Android Full support 18 | Edge Mobile Full support Yes | Firefox Android Full support 4 | Opera Android Full support Yes | Safari iOS Full support Yes | Samsung Internet Android Full support Yes | nodejs Full support Yes

### Legend

Full support
  Full support
No support
  No support
Compatibility unknown
  Compatibility unknown
See implementation notes.
  See implementation notes.
User must explicitly enable this feature.
  User must explicitly enable this feature.

## 参阅

- `function statement`
- `function expression`
- `function* statement`
- `function* expression`
- `Function`
- `GeneratorFunction`
- `Arrow functions`
- `Default parameters`
- `Rest parameters`
- `Arguments object`
- `getter`
- `setter`
- `Method definitions`
- Functions and function scope