noConfusingLabels

import { Tabs, TabItem } from '@astrojs/starlight/components';

<Tabs> <TabItem label="JavaScript (and super languages)" icon="seti:javascript"> ## Summary - Rule available since: `v1.0.0` - Diagnostic Category: [`lint/suspicious/noConfusingLabels`](/reference/diagnostics#diagnostic-category) - This rule is **recommended**, meaning it is enabled by default. - This rule doesn't have a fix. - The default severity of this rule is [**warning**](/reference/diagnostics#warning). - Sources: - Inspired from [`no-labels`](https://eslint.org/docs/latest/rules/no-labels)

How to configure

json

{
	"linter": {
		"rules": {
			"suspicious": {
				"noConfusingLabels": "error"
			}
		}
	}
}

Description

Disallow labeled statements that are not loops.

Labeled statements in JavaScript are used in conjunction with break and continue to control flow around multiple loops. Their use for other statements is suspicious and unfamiliar.

The rule ignores reactive Svelte statements in Svelte components.

Examples

Invalid

label: f();

<pre class="language-text"><code class="language-text">code-block.js:1:1 <a href="https://biomejs.dev/linter/rules/no-confusing-labels">lint/suspicious/noConfusingLabels</a> ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ⚠ Unexpected label. > 1 │ label: f(); │ ^^^^^ 2 │ ℹ Only loops should be labeled. The use of labels for other statements is suspicious and unfamiliar. </code></pre>

label: {
    f();
    break label;
}

<pre class="language-text"><code class="language-text">code-block.js:1:1 <a href="https://biomejs.dev/linter/rules/no-confusing-labels">lint/suspicious/noConfusingLabels</a> ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ⚠ Unexpected label. > 1 │ label: { │ ^^^^^ 2 │ f(); 3 │ break label; ℹ Only loops should be labeled. The use of labels for other statements is suspicious and unfamiliar. </code></pre>

label: if (a) {
    f()
    break label;
}

<pre class="language-text"><code class="language-text">code-block.js:1:1 <a href="https://biomejs.dev/linter/rules/no-confusing-labels">lint/suspicious/noConfusingLabels</a> ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ⚠ Unexpected label. > 1 │ label: if (a) { │ ^^^^^ 2 │ f() 3 │ break label; ℹ Only loops should be labeled. The use of labels for other statements is suspicious and unfamiliar. </code></pre>

label: switch (a) {
    case 0:
        break label;
}

<pre class="language-text"><code class="language-text">code-block.js:1:1 <a href="https://biomejs.dev/linter/rules/no-confusing-labels">lint/suspicious/noConfusingLabels</a> ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ⚠ Unexpected label. > 1 │ label: switch (a) { │ ^^^^^ 2 │ case 0: 3 │ break label; ℹ Only loops should be labeled. The use of labels for other statements is suspicious and unfamiliar. </code></pre>

Valid

outer: while (a) {
    while(b) {
        break outer;
    }
}

svelte

<script>
$: { /* reactive block */ }
</script>

Options

Use the options to allow specific labels in your code. Labels can be used to mark code that should be removed under certain conditions, such as in production builds. Some bundlers, such as esbuild and Vite, can be configured to remove labeled statements.