JavaScript Semicolons: Are They Required? A Complete Guide

Understand the role of semicolons in JavaScript, when they are required, when they are optional, and how automatic semicolon insertion affects your code. Make an informed style choice for your projects.

JavaScriptbeginner
10 min read

The semicolon debate is one of the most persistent style discussions in the JavaScript community. Some developers insist on writing them everywhere, while others leave them out entirely. The truth is that JavaScript has complex rules about when semicolons are required and when the engine inserts them automatically. Understanding these rules lets you make an informed decision rather than relying on habit or hearsay.

JavaScript is one of the few programming languages where statement terminators are sometimes optional. The language includes a feature called Automatic Semicolon Insertion (ASI) that adds semicolons during parsing. This means code can work without explicit semicolons in many situations, but there are specific cases where omitting them causes real bugs. This guide covers all of it so you can write JavaScript with full confidence.

What Semicolons Do in JavaScript

Semicolons serve as statement terminators. They tell the JavaScript engine where one statement ends and the next begins:

javascriptjavascript
// Each semicolon marks the end of a statement
let name = "Alice";
let age = 30;
console.log(name);

Without semicolons, the engine must figure out where statements end. In most cases it succeeds, but in some edge cases it fails in surprising ways.

When Semicolons Are Required

There are specific situations where you must use a semicolon regardless of your coding style:

1. Multiple Statements on One Line

When you place two or more statements on the same line, semicolons are mandatory as separators:

javascriptjavascript
// Required: semicolons separate statements on one line
let x = 1; let y = 2; let z = x + y;
 
// Without semicolons, this is a syntax error
// let x = 1 let y = 2 let z = x + y  // SyntaxError

2. The for Loop Header

The for loop uses semicolons to separate its three expressions. These cannot be omitted:

javascriptjavascript
// Required: semicolons in the for loop header
for (let i = 0; i < 10; i++) {
  console.log(i);
}
 
// The semicolons here are part of the syntax, not style

3. Before Statements Starting with (, [, or `

This is the most important case. If a new line starts with a parenthesis, bracket, or template literal backtick, and you omitted the previous semicolon, the engine may combine the two lines into one expression:

javascriptjavascript
// DANGER: without semicolon, these lines merge
const message = "hello"
["world"].forEach(item => console.log(item))
// JavaScript reads this as: "hello"["world"].forEach(...)
// Result: TypeError because "hello"["world"] is undefined
 
// FIX: add a semicolon
const message = "hello";
["world"].forEach(item => console.log(item));
javascriptjavascript
// DANGER: IIFE without semicolon on previous line
const value = 42
(function() {
  console.log("IIFE");
})()
// JavaScript reads this as: 42(function() { ... })()
// Result: TypeError: 42 is not a function
 
// FIX: add a semicolon before the IIFE
const value = 42;
(function() {
  console.log("IIFE");
})();
The Three Dangerous Characters

Lines starting with (, [, or ` can merge with the previous line if no semicolon is present. Even developers who prefer the no-semicolon style must add defensive semicolons before these characters. Many no-semicolon guides call this the "leading semicolon" or "defensive semicolon" pattern.

Dangerous Characters Reference Table

Starting CharacterRiskExample of Bug
(Previous line called as functionvalue(function() {})
[Previous line used as property access"string"["method"]
`Previous line tagged as template literalvalue\template``
/Previous line dividedvalue / regex / (rare)
+ or -Unary plus/minus on previous valuevalue + nextValue (rare)

When Semicolons Are Optional

In most other situations, JavaScript's ASI mechanism correctly inserts semicolons for you:

javascriptjavascript
// ASI handles these fine without explicit semicolons
let name = "Alice"
let age = 30
const greeting = `Hello, ${name}`
console.log(greeting)
 
// Function declarations
function add(a, b) {
  return a + b
}
 
// if/else, while, for...of
if (age > 18) {
  console.log("Adult")
}
 
for (const char of name) {
  console.log(char)
}

Statements That Never Need Semicolons

These structures have their own block delimiters (curly braces) and never take a trailing semicolon:

javascriptjavascript
// NO semicolons after these (adding one is harmless but unnecessary)
if (condition) { }
for (let i = 0; i < n; i++) { }
while (condition) { }
function greet() { }
class Animal { }
switch (value) { }
try { } catch (e) { }
Blocks vs. Expressions

Block statements (if, for, while, function declarations, class declarations) are terminated by their closing brace. Adding a semicolon after them is harmless because it creates an empty statement, but it is unnecessary and most style guides discourage it.

The Two Camps: Semicolons vs. No Semicolons

Always Use Semicolons

This camp follows the philosophy: "Be explicit rather than relying on implicit behavior."

Arguments for:

  • Eliminates all ASI-related bugs by default
  • Code is unambiguous to both humans and tools
  • Many popular style guides recommend them (Google, Airbnb)
  • Makes it easier to move lines of code around without worrying about context
javascriptjavascript
// Always-semicolons style
const API_URL = "https://api.example.com";
const timeout = 5000;
 
async function fetchData(endpoint) {
  const response = await fetch(`${API_URL}/${endpoint}`);
  const data = await response.json();
  return data;
}

Never Use Semicolons (Rely on ASI)

This camp follows the philosophy: "Remove unnecessary syntax noise."

Arguments for:

  • Cleaner, less cluttered visual appearance
  • JavaScript was designed to work without them
  • Popular frameworks (Vue) use this style
  • StandardJS enforces no semicolons and has millions of downloads
javascriptjavascript
// No-semicolons style (with defensive semicolons where needed)
const API_URL = "https://api.example.com"
const timeout = 5000
 
async function fetchData(endpoint) {
  const response = await fetch(`${API_URL}/${endpoint}`)
  const data = await response.json()
  return data
}

Style Guide Comparison

Style GuideSemicolon PolicyUsed By
AirbnbAlways requiredAirbnb, many startups
GoogleAlways requiredGoogle, enterprise teams
StandardJSNever (with exceptions)Vue, many open-source projects
Prettier (default)Always requiredConfigurable, default is "always"
ESLint (default)No enforced preferenceDepends on config

Configuring Your Tools

Prettier

jsonjson
{
  "semi": true
}

Set "semi": false to remove semicolons:

jsonjson
{
  "semi": false
}

ESLint

javascriptjavascript
// eslint.config.mjs
export default [
  {
    rules: {
      // Require semicolons
      "semi": ["error", "always"],
 
      // Or: disallow semicolons
      // "semi": ["error", "never"],
 
      // Prevent ASI-related bugs (useful when NOT using semicolons)
      "no-unexpected-multiline": "error"
    }
  }
];
Use Both Prettier and ESLint

The most robust setup is Prettier for formatting (including semicolon insertion or removal) plus ESLint's no-unexpected-multiline rule for catching the rare ASI edge cases. This combination prevents bugs regardless of which semicolon style you choose.

The Defensive Semicolon Pattern

If you choose the no-semicolon style, you need to know one pattern: the defensive semicolon. Place a semicolon at the start of any line that begins with (, [, or `:

javascriptjavascript
// No-semicolon style with defensive semicolons
const data = getData()
 
// Defensive semicolon prevents [array] from being parsed
// as property access on getData()'s return value
;["apple", "banana", "cherry"].forEach(fruit => {
  console.log(fruit)
})
 
// Defensive semicolon prevents (function) from being
// parsed as a function call on the previous expression
const config = loadConfig()
;(function() {
  initializeApp(config)
})()

The leading semicolon acts as a safety net, ensuring the line is always parsed as a new statement regardless of what comes before it.

Best Practices

Pick one style and enforce it with tooling. The worst semicolon style is inconsistency. Whether you choose "always" or "never," configure Prettier and ESLint to enforce your choice automatically. This eliminates the mental overhead of making decisions line by line.

Always enable the no-unexpected-multiline rule. This ESLint rule catches the dangerous cases where ASI produces unexpected behavior. It is useful regardless of your semicolon preference and prevents the (, [, and ` bugs described above.

Understand the rules before choosing a side. Developers who blindly follow "always use semicolons" or "never use semicolons" without understanding ASI will eventually write buggy code. Read the ASI explanation so you know what the engine does with your code.

Match your team's existing style. If you join a project that uses semicolons, use semicolons. If you join one that does not, follow that convention. Personal preference matters less than project consistency.

Do not manually add semicolons after block statements. Adding semicolons after if, for, while, function, or class blocks is unnecessary and misleading. Let your formatter handle this consistently.

Common Mistakes and How to Avoid Them

Avoid These Semicolon Traps

These mistakes are responsible for the majority of semicolon-related bugs in real JavaScript projects.

Putting a semicolon after an if condition. This creates an empty statement, so the block always executes:

javascriptjavascript
// BUG: semicolon after if() creates an empty statement
if (isAdmin); {
  // This block ALWAYS runs, regardless of isAdmin
  deleteAllRecords();
}
 
// FIX: remove the semicolon
if (isAdmin) {
  deleteAllRecords();
}

Missing semicolons before IIFE patterns. When concatenating files or writing modules without a bundler, a missing semicolon before an immediately invoked function expression causes the previous expression to be called as a function.

Semicolons inside for...of and for...in headers. These loop types use of/in keywords, not semicolons:

javascriptjavascript
// WRONG: semicolons in for...of
// for (const item; of items;) { }  // SyntaxError
 
// CORRECT: no semicolons in for...of
for (const item of items) {
  console.log(item);
}
 
// Semicolons are ONLY used in the classic for loop
for (let i = 0; i < items.length; i++) {
  console.log(items[i]);
}

Relying on ASI with return statements. If you place the return value on a new line, ASI inserts a semicolon after return, giving you undefined:

javascriptjavascript
// BUG: ASI inserts semicolon after return
function getConfig() {
  return
  {
    debug: true,
    verbose: false
  };
}
console.log(getConfig()); // undefined, not the object
 
// FIX: start the return value on the same line
function getConfig() {
  return {
    debug: true,
    verbose: false
  };
}

Next Steps

Choose a semicolon style for your project

Decide whether your team will use "always" or "never" semicolons. If starting a new project, either choice is fine. Look at the frameworks and libraries you use most and match their convention.

Configure Prettier and ESLint

Set Prettier's semi option to match your choice. Enable ESLint's no-unexpected-multiline rule. Run both tools on your existing codebase to apply the style consistently.

Learn ASI rules in depth

Read the complete guide to Automatic Semicolon Insertion to understand exactly when and how the engine inserts semicolons. This knowledge prevents bugs regardless of your style preference.

Review your existing code for ASI hazards

Search your codebase for lines starting with (, [, or template literals that follow a line without a semicolon. These are potential bug sites. Add defensive semicolons or explicit semicolons as needed.

Rune AI

Rune AI

Key Insights

  • Mostly optional: ASI handles semicolons correctly in the majority of JavaScript code
  • Three danger characters: lines starting with (, [, or ` can merge with the previous line without semicolons
  • for loop requires them: the classic for loop header always needs semicolons to separate its three expressions
  • Tooling enforces consistency: Prettier and ESLint eliminate the need for manual semicolon decisions
  • return statement trap: never place the return value on a new line, or ASI inserts a semicolon after return
RunePowered by Rune AI

Frequently Asked Questions

Are semicolons mandatory in JavaScript?

No. JavaScript has Automatic Semicolon Insertion (ASI), which means the engine adds semicolons during parsing in most places where they are needed. However, there are specific cases where omitting a semicolon causes bugs, particularly when a line starts with `(`, `[`, or a template literal backtick. For the classic `for` loop header, semicolons are always required syntax.

What happens if I forget a semicolon in JavaScript?

In most cases, nothing bad happens. ASI correctly inserts the missing semicolons and your code runs as expected. In a few edge cases, the engine merges two lines into a single statement, causing unexpected behavior or TypeError exceptions. Using a linter with the `no-unexpected-multiline` rule catches these cases before they reach production.

Do professional JavaScript developers use semicolons?

Both conventions are common in professional codebases. Google and Airbnb style guides require semicolons. StandardJS and many Vue/Nuxt projects omit them. The key is consistency: professional teams pick one style, enforce it with tooling, and never mix styles in the same project.

Should I use semicolons in TypeScript?

TypeScript follows the same ASI rules as JavaScript, so the choice is the same. Most TypeScript projects (including the TypeScript compiler itself) use semicolons, partly because the TypeScript community tends toward explicit, verbose code. However, omitting semicolons works just as well in TypeScript as in JavaScript.

Does omitting semicolons affect performance?

No. ASI runs during the parsing phase, which happens once before any code executes. The parsing overhead of inserting semicolons is negligible compared to actual code execution. Minifiers like Terser intelligently handle semicolons in the output, so the final bundle size is not affected by your style choice.

What is the defensive semicolon pattern?

The defensive semicolon is a semicolon placed at the beginning of a line that starts with `(`, `[`, or a template literal. Developers who omit semicolons use this pattern to prevent ASI-related bugs: `;["a", "b"].forEach(...)`. It ensures the line is always parsed as a new statement regardless of the previous line.

Conclusion

JavaScript semicolons are optional in most cases thanks to Automatic Semicolon Insertion, but a few specific situations require them to avoid bugs. The most important thing is choosing one style, using Prettier and ESLint to enforce it, and knowing the edge cases where ASI can fail. Whether you write every semicolon or leave them out, understanding how JavaScript actually parses your code is the skill that prevents real bugs.