label

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

标记语句是任何带有标识符前缀的语句。你可以使用嵌套在标记语句中的 break 或 continue 语句跳转到对应标记。

尝试一下

let str = "";

loop1: for (let i = 0; i < 5; i++) {
  if (i === 1) {
    continue loop1;
  }
  str = str + i;
}

console.log(str);
// Expected output: "0234"

语法

js
label:
  statement
label

任何不属于保留字的 JavaScript 标识符。

statement

JavaScript 语句。break 可以在任何标记语句中使用，而 continue 可以在标记的循环语句中使用。

描述

你可以使用标签来标识语句，并在后续使用 break 或 continue 语句来引用该标签。请注意，JavaScript 没有 goto 语句；你只能将标签与 break 或 continue 一起使用。

任何引用 label 的 break 或 continue 语句都必须位于标记语句 label 所标记的语句的范围内。把 label 看作是仅在 statement 作用域内可用的变量。

如果在执行 statement 时遇到 break label; 语句，则 statement 执行终止，并继续执行标记的语句之后的语句。

continue label; 只能在 statement 是循环语句时使用。如果在执行 statement 时遇到 continue label; 语句，则 statement 继续执行循环的下一次迭代。不带标签的 continue; 语句只能继续最内层的循环，而 continue label; 语句可以继续任何给定的循环，即使该语句嵌套在其他循环中。

一个语句可以有多个标签。在这种情况下，这些标签在功能上都是等价的。

示例

在 for 循环中使用带标签的 continue 语句

js
// 第一个 for 语句被标记为“loop1”
loop1: for (let i = 0; i < 3; i++) {
  // 第二个 for 语句被标记为“loop2”
  loop2: for (let j = 0; j < 3; j++) {
    if (i === 1 && j === 1) {
      continue loop1;
    }
    console.log(`i = ${i}, j = ${j}`);
  }
}

// 输出：
// i = 0, j = 0
// i = 0, j = 1
// i = 0, j = 2
// i = 1, j = 0
// i = 2, j = 0
// i = 2, j = 1
// i = 2, j = 2

注意它如何跳过“i = 1, j = 1”和“i = 1, j = 2”。

在 for 循环中使用带标签的 break 语句

js
let i, j;

// 第一个 for 语句被标记为“loop1”
loop1: for (i = 0; i < 3; i++) {
  // 第二个 for 语句被标记为“loop2”
  loop2: for (j = 0; j < 3; j++) {
    if (i === 1 && j === 1) {
      break loop1;
    }
    console.log(`i = ${i}, j = ${j}`);
  }
}

// 输出：
// i = 0, j = 0
// i = 0, j = 1
// i = 0, j = 2
// i = 1, j = 0

请注意和前面的 continue 示例的区别：当遇到 break loop1 时，外层循环的执行终止，因此之后的日志都不会再输出；当遇到 continue loop1 时，外层循环的执行会继续下一次迭代，因此会跳过“i = 1, j = 1”和“i = 1, j = 2”。

使用带标签的 continue 语句

给定一个数据数组和一个测试数组，下面的例子会统计通过测试的数据的数量。

js
// 从 1 到 100 的数字
const items = Array.from({ length: 100 }, (_, i) => i + 1);
const tests = [
  { pass: (item) => item % 2 === 0 },
  { pass: (item) => item % 3 === 0 },
  { pass: (item) => item % 5 === 0 },
];
let itemsPassed = 0;

itemIteration: for (const item of items) {
  for (const test of tests) {
    if (!test.pass(item)) {
      continue itemIteration;
    }
  }

  itemsPassed++;
}

请注意 continue itemIteration; 语句如何跳过当前项的其余测试以及更新 itemsPassed 计数器的语句，并继续下一个项目。如果你不使用标签，则需要使用布尔标志。

js
// 从 1 到 100 的数字
const items = Array.from({ length: 100 }, (_, i) => i + 1);
const tests = [
  { pass: (item) => item % 2 === 0 },
  { pass: (item) => item % 3 === 0 },
  { pass: (item) => item % 5 === 0 },
];
let itemsPassed = 0;

for (const item of items) {
  let passed = true;
  for (const test of tests) {
    if (!test.pass(item)) {
      passed = false;
      break;
    }
  }
  if (passed) {
    itemsPassed++;
  }
}

使用带标签的 break 语句

给定一个数据数组和一个测试数组，下面的例子会确定所有数据是否通过所有测试。

js
// 从 1 到 100 的数字
const items = Array.from({ length: 100 }, (_, i) => i + 1);
const tests = [
  { pass: (item) => item % 2 === 0 },
  { pass: (item) => item % 3 === 0 },
  { pass: (item) => item % 5 === 0 },
];
let allPass = true;

itemIteration: for (const item of items) {
  for (const test of tests) {
    if (!test.pass(item)) {
      allPass = false;
      break itemIteration;
    }
  }
}

同样，如果你不使用标签，则需要使用布尔标志。

js
// 从 1 到 100 的数字
const items = Array.from({ length: 100 }, (_, i) => i + 1);
const tests = [
  { pass: (item) => item % 2 === 0 },
  { pass: (item) => item % 3 === 0 },
  { pass: (item) => item % 5 === 0 },
];
let allPass = true;

for (const item of items) {
  let passed = true;
  for (const test of tests) {
    if (!test.pass(item)) {
      passed = false;
      break;
    }
  }
  if (!passed) {
    allPass = false;
    break;
  }
}

在带标签的块语句中使用 break

你可以标记除循环语句以外的语句，例如简单的块，但只有 break 语句才能引用非循环标签。

js
foo: {
  console.log("脸");
  break foo;
  console.log("这句不会被执行");
}
console.log("交换");

// 输出：
// "脸"
// "交换"

标记函数声明

只能标记语句而不能标记声明。在非严格代码中，有一种遗留语法允许使用标签来标记函数声明：

js
L: function F() {}

在严格模式下，这将会抛出一个 SyntaxError：

js
"use strict";
L: function F() {}
// SyntaxError: functions cannot be labelled

非普通函数，例如生成器函数和异步函数既不能在严格代码中进行标记，也不能在非严格代码中进行标记：

js
L: function* F() {}
// SyntaxError: generator functions cannot be labelled

函数声明标记语法已弃用，并且即使是在非严格代码中，也不应该使用。你不能在函数体内跳转到此标签。

规范

Specification
ECMAScript® 2026 Language Specification
# sec-labelled-statements

浏览器兼容性

参见