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.
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:
// 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:
// 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 // SyntaxError2. The for Loop Header
The for loop uses semicolons to separate its three expressions. These cannot be omitted:
// 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 style3. 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:
// 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));// 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 Character | Risk | Example of Bug |
|---|---|---|
( | Previous line called as function | value(function() {}) |
[ | Previous line used as property access | "string"["method"] |
` | Previous line tagged as template literal | value\template`` |
/ | Previous line divided | value / regex / (rare) |
+ or - | Unary plus/minus on previous value | value + nextValue (rare) |
When Semicolons Are Optional
In most other situations, JavaScript's ASI mechanism correctly inserts semicolons for you:
// 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:
// 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
// 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
// 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 Guide | Semicolon Policy | Used By |
|---|---|---|
| Airbnb | Always required | Airbnb, many startups |
| Always required | Google, enterprise teams | |
| StandardJS | Never (with exceptions) | Vue, many open-source projects |
| Prettier (default) | Always required | Configurable, default is "always" |
| ESLint (default) | No enforced preference | Depends on config |
Configuring Your Tools
Prettier
{
"semi": true
}Set "semi": false to remove semicolons:
{
"semi": false
}ESLint
// 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 `:
// 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:
// 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:
// 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:
// 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
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
Frequently Asked Questions
Are semicolons mandatory in JavaScript?
What happens if I forget a semicolon in JavaScript?
Do professional JavaScript developers use semicolons?
Should I use semicolons in TypeScript?
Does omitting semicolons affect performance?
What is the defensive semicolon pattern?
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.
More in this topic
OffscreenCanvas API in JS for UI Performance
Master the OffscreenCanvas API to offload rendering from the main thread. Covers worker-based 2D and WebGL rendering, animation loops inside workers, bitmap transfer, double buffering, chart rendering pipelines, image processing, and performance measurement strategies.
Advanced Web Workers for High Performance JS
Master Web Workers for truly parallel JavaScript execution. Covers dedicated and shared workers, structured cloning, transferable objects, SharedArrayBuffer with Atomics, worker pools, task scheduling, Comlink RPC patterns, module workers, and performance profiling strategies.
JavaScript Macros and Abstract Code Generation
Master JavaScript code generation techniques for compile-time and runtime metaprogramming. Covers AST manipulation, Babel plugin authorship, tagged template literals as macros, code generation pipelines, source-to-source transformation, compile-time evaluation, and safe eval alternatives.