JavaScript Notes
HubYour First JavaScript Program — Hello World & Beyond Complete Guide 2026History of JavaScript — Complete Timeline from 1995 to 2026How JavaScript Runs — Complete Guide to Execution, Call Stack & Event LoopJavaScript Engine Explained — V8, JIT Compilation & How Code Gets FastJavaScript Use Cases — 15 Things You Can Build with JavaScript (2026)JavaScript vs Other Languages — Complete Comparison Guide 2026What is JavaScript? Complete BeginnerWhy Learn JavaScript in 2026? Career, Salary, Scope & Benefits GuideJavaScript Break Statement Tutorial – Complete Guide with ExamplesJavaScript Break and Continue Statements – Complete Guide with ExamplesJavaScript Continue Statement Tutorial – Skip Iterations with ExamplesJavaScript Do While Loop Tutorial – Execute at Least Once with ExamplesJavaScript Do-While Loop Tutorial – Complete Guide with ExamplesJavaScript For Loop Tutorial – Complete Guide with ExamplesJavaScript If Statement Tutorial – Conditional Logic with ExamplesJavaScript If Else Statement Tutorial – Complete Guide with ExamplesJavaScript If Statement Tutorial – Complete Guide with ExamplesJavaScript Nested If Statement Tutorial – Multi-Level Conditions with ExamplesNested Loops in JavaScriptJavaScript Control Flow Practice Programs – 20+ Exercises with SolutionsJavaScript Switch Statement Tutorial – Case Matching with ExamplesSwitch Statement in JavaScriptJavaScript While Loop Tutorial – Complete Guide with ExamplesJavaScript Arrow Functions Tutorial – Syntax, Use Cases & this BindingJavaScript Callback Functions Explained – Synchronous & AsynchronousJavaScript Closures Explained – Lexical Scope, Private State & MemoryJavaScript Function Declaration Tutorial – Hoisting, Syntax & ScopeJavaScript Function Expression Tutorial – Anonymous, Named & AssignedJavaScript Higher Order Functions Tutorial – map, filter, reduce & Custom HOFsJavaScript IIFE Explained – Immediately Invoked Function ExpressionJavaScript Functions Practice Programs – 20+ Exercises with SolutionsJavaScript Recursion Tutorial – Call Stack, Base Case & Recursive PatternsJavaScript Array Basics - Complete BeginnerJavaScript Array Methods - Complete Reference Guide with ExamplesJavaScript Array Programs - 20+ Practice Problems with SolutionsJavaScript Arrays Basics - Complete Guide with Examples & DiagramsJavaScript Array filter() Method - Complete Tutorial with ExamplesJavaScript filter() Method — Complete Guide with Examples 2026JavaScript Array find() Method - Complete Tutorial with ExamplesJavaScript find() & findIndex() — Complete Guide 2026JavaScript Array map() Method - Complete Tutorial with ExamplesJavaScript map() Method — Transform Arrays Complete Guide 2026JavaScript map() vs forEach() - Key Differences with ExamplesJavaScript Array push() and pop() - Complete Tutorial with ExamplesJavaScript Array reduce() Method - Complete Tutorial with ExamplesJavaScript reduce() Method — Complete Deep Dive with Examples 2026JavaScript Array shift() and unshift() - Complete Tutorial with ExamplesJavaScript Array sort() Method - Complete Tutorial with ExamplesJavaScript splice() vs slice() - Complete Tutorial with ExamplesJavaScript Object Destructuring - Complete Guide with ExamplesJavaScript Objects - Complete Guide to Object Basics with ExamplesJavaScript Object Methods - Built-in Methods & Custom Methods Complete GuideJavaScript Object Programs - Practice Problems with SolutionsJavaScript Object Properties - Keys, Values, Descriptors & Dynamic PropertiesJavaScript Rest Operator (...) - Parameters, Destructuring & Complete GuideJavaScript Spread Operator (...) - Complete Guide with ExamplesJavaScript this Keyword - Complete Guide with Binding Rules & ExamplesJavaScript String Basics - Complete Guide to Strings with ExamplesJavaScript String Methods - Complete Reference with Examples & OutputJavaScript String Programs - Practice Problems with SolutionsJavaScript String Replacing - replace(), replaceAll() & Regex Patterns GuideJavaScript String Searching Methods - includes, indexOf, startsWith, match GuideJavaScript Template Literals (ES6) - Complete Guide with Tagged TemplatesJavaScript DOM Changing Content - textContent, innerHTML, setAttribute Complete GuideJavaScript DOM Changing Styles - CSS Manipulation, classList & getComputedStyleJavaScript DOM Creating Elements - createElement, appendChild, DocumentFragment GuideJavaScript DOM Introduction - Complete Guide to Document Object ModelJavaScript DOM Traversal - Navigate Parent, Child & Sibling NodesJavaScript DOM Forms - Form Handling, Validation & FormData Complete GuideJavaScript localStorage - Complete Guide to Web Storage APIlocalStorage vs sessionStorage - JavaScript Web Storage Comparison GuideJavaScript DOM Removing Elements - remove(), removeChild() Complete GuideJavaScript DOM Selecting Elements - querySelector, getElementById Complete GuideJavaScript sessionStorage - Complete Guide to Session-Based Web StorageJavaScript Click Event - addEventListener, Event Handler Complete GuideEvent Bubbling in JavaScript – Complete Guide with Examples (2026)Event Capturing in JavaScript – Complete Guide to Capture Phase (2026)Event Delegation in JavaScript – Complete Guide with Examples (2026)JavaScript Event Object – Complete Guide with Examples (2026)JavaScript Form Events – Complete Guide with Examples (2026)JavaScript Keyboard Events – Complete Guide to keydown, keyup & Key Properties (2026)JavaScript Mouse Events – Complete Guide with Examples (2026)JavaScript Async Await - Complete Guide with Examples & Error HandlingJavaScript Call Stack - Complete Guide with Visual Diagrams & ExamplesJavaScript Callback Queue (Task Queue) - Complete Guide with DiagramsJavaScript Callbacks - Complete Guide with Callback Hell & PatternsJavaScript Event Loop - Complete Guide with Visual Diagrams & ExamplesJavaScript Fetch API - Complete Guide with Examples, Error Handling & Async/AwaitJSON in JavaScript - Complete Guide: Parse, Stringify, Fetch & Error HandlingJavaScript Promise.all, Promise.race, Promise.any, Promise.allSettled — Complete Guide 2026JavaScript Promises - Complete Guide with Chaining, Error Handling & Event LoopSynchronous vs Asynchronous JavaScript — Complete Explanation 2026JavaScript Web APIs - Complete Guide: setTimeout, fetch, DOM Events & MoreClosures in JavaScript — Complete Guide with Examples 2026Hoisting in JavaScript — Complete Guide with Examples 2026Prototype in JavaScript — Complete Guide with Examples 2026Scope in JavaScript — Complete Guide with Examples 2026Browser Object Model (BOM) in JavaScript — Complete GuideCanvas API in JavaScript — Complete Drawing & Animation GuideDrag and Drop API in JavaScript — Complete TutorialGeolocation API in JavaScript — Get User Location TutorialHistory API in JavaScript — SPA Routing & pushState GuideNotification API in JavaScript — Push Notifications TutorialService Workers in JavaScript — Offline, Caching & PWA GuideWeb Storage API in JavaScript — localStorage & sessionStorage GuideWeb Workers in JavaScript — Multithreading & Background Tasks GuideJavaScript Interview — Behavioral Questions and Soft Skills Guide 2026Common JavaScript Interview Mistakes — What to Avoid 2026JavaScript Interview Tips — Strategy and Preparation Guide 2026JavaScript Mock Interview — Practice Questions with Solutions 2026JavaScript System Design — Frontend Architecture Interview Guide 2026JavaScript apply() Method - Complete Guide with ExamplesJavaScript bind() Method - Complete Guide with ExamplesJavaScript call() Method - Complete Guide with ExamplesJavaScript call() vs apply() vs bind() - Complete Comparison GuideJavaScript Currying - Complete Guide with ExamplesJavaScript Debounce - Complete Guide with Timeline DiagramsJavaScript Execution Context - Complete Guide with Stack DiagramsJavaScript Garbage Collection - Memory Lifecycle & Mark-and-Sweep GuideJavaScript Generators - Complete Guide with yield and IterationJavaScript Hoisting - Complete Guide with var, let, const & FunctionsJavaScript Iterators - Complete Guide with Iterator ProtocolJavaScript Lexical Scope - Complete Guide with Scope Chain DiagramsJavaScript Memory Management - Complete Guide with Lifecycle DiagramsJavaScript Modules - Complete Guide with import export ExamplesJavaScript Scope - Complete Guide with var, let, const & Scope ChainJavaScript Symbols - Complete Guide with Well-Known SymbolsJavaScript Throttle - Complete Guide with Timeline DiagramsJavaScript Comments Complete Guide – Single Line, Multi-line & JSDoc with ExamplesJavaScript Data Types Complete Guide – Primitives, Objects & typeof with ExamplesJavaScript Input and Output Complete Guide – console.log, prompt, alert & DOM with ExamplesJavaScript Keywords Complete Guide – Reserved Words List with Examples for BeginnersJavaScript null vs undefined – Complete Guide with Differences, Examples & Interview Q&AJavaScript Operators Complete Guide – Arithmetic, Comparison, Logical & More with ExamplesJavaScript Strict Mode Complete Guide – JavaScript Type Conversion Complete Guide – Explicit & Implicit Coercion with ExamplesJavaScript var vs let vs const – Complete Guide with Scope, Hoisting & Best PracticesJavaScript Variables Complete Guide – Declaration, Naming Rules & Memory Model for BeginnersDeque (Double-Ended Queue) in JavaScript — Complete GuideLinked List in JavaScript — Nodes, Pointers & Operations GuideJavaScript Map — Key-Value Data Structure Complete GuideJavaScript Numbers — IEEE 754, Precision, and Number Methods GuidePriority Queue in JavaScript — Min Heap Implementation GuideQueue Data Structure in JavaScript — FIFO, Enqueue & Dequeue ExplainedJavaScript Set — Unique Values Data Structure GuideSorting Algorithms in JavaScript — Bubble, Merge, Quick Sort GuideStack Data Structure in JavaScript — LIFO, Push, Pop ExplainedJavaScript Typed Arrays — ArrayBuffer, Int32Array, Float64Array GuideJavaScript WeakMap — Weak References, Memory Management GuideJavaScript WeakSet — Complete Guide with Examples 2026Applications of JavaScript — Where JS is Used in 2026 Complete GuideJavaScript Backend Frameworks — Node.js, Express, NestJS Complete Guide 2026JavaScript Frontend Libraries — React, Vue, Angular, Svelte Complete Overview 2026JavaScript Full-Stack Frameworks — Next.js, Remix, Astro Complete Guide 2026JavaScript Career Paths & Jobs — Salary, Roles & Roadmap 2026JavaScript Libraries vs Frameworks — Difference & Examples Complete Guide 2026JavaScript Custom Errors – Extend Error Class, Custom Error Types & instanceofJavaScript Debugging – console Methods, DevTools, Breakpoints & Error Stack TracesJavaScript throw Statement – Throw Errors, Custom Messages & Error TypesJavaScript Try Catch Finally – Error Handling Complete GuideTop 30 JavaScript Closure Interview Questions & Answers 2026Top 30 JavaScript Coding Interview Questions 2026 (With Solutions)Top 25 JavaScript Event Loop Interview Questions & Answers 2026Top 50 JavaScript Interview Questions & Answers 2026Top 30 JavaScript Promise Interview Questions & Answers 202650 Tricky JavaScript Output Questions 2026 (With Answers)Build a JavaScript Calculator - Step by Step Project TutorialBuild a JavaScript Image Carousel - Step by Step Project TutorialBuild a JavaScript Counter Application - Step by Step Project TutorialBuild a JavaScript Digital Clock - Step by Step Project TutorialBuild a Dynamic Resume Builder in JavaScript - Step by Step TutorialBuild a JavaScript Email Validator - Step by Step Project TutorialBuild a JavaScript Employee Database Management App - Step by Step TutorialBuild a JavaScript Expense Tracker - Step by Step Project TutorialBuild a GitHub Profile Search App in JavaScript - Step by Step TutorialBuild a JavaScript Image Slider - Step by Step Project TutorialBuild a JavaScript Multi-Step Progress Bar - Step by Step TutorialBuild JavaScript Nested Chat Comments - Step by Step Project TutorialBuild a JavaScript Notes App - Step by Step Project TutorialBuild a JavaScript OTP Input Field - Step by Step Project TutorialBuild a JavaScript Palindrome Checker - Step by Step Project TutorialBuild a JavaScript Price Range Slider - Step by Step Project TutorialBuild a JavaScript Prime Number Checker - Step by Step Project TutorialBuild a JavaScript QR Code Generator - Step by Step Project TutorialBuild a JavaScript QR Code Scanner - Step by Step Project TutorialBuild a JavaScript Quiz App - Step by Step Project TutorialBuild a JavaScript Random Number Generator - Step by Step TutorialBuild a JavaScript Random Password Generator - Step by Step TutorialJavaScript Image Resize & Compress — Canvas API Project 2026JavaScript Responsive Admin Dashboard — DOM & CSS Project 2026JavaScript Show/Hide Password Toggle — Beginner DOM Project 2026JavaScript Sortable Filterable Table — DOM & Array Methods Project 2026JavaScript Stopwatch Project — setInterval & DOM Tutorial 2026JavaScript Student Grade Calculator — Arrays & Logic Project 2026JavaScript Task Scheduler Project — CRUD & localStorage Tutorial 2026JavaScript Tic-Tac-Toe Game — DOM Manipulation Project Tutorial 2026JavaScript Toast Notification Project — Custom Alerts Tutorial 2026Build a Todo App in JavaScript - Step by Step Project TutorialJavaScript Unicode Character Value Finder — charCodeAt & fromCharCode Project 2026JavaScript Weather App Project — Fetch API & DOM Complete Tutorial 2026JavaScript Cheat Sheet 2026 — Complete Quick ReferenceImportant JavaScript Concepts Every Developer Must Know in 2026JavaScript One Shot Notes 2026 — Complete JS in One PageJavaScript Quick Revision Notes — Interview Prep in 30 Minutes 2026Abstraction in JavaScript OOP – Hide Complexity, Expose SimplicityJavaScript Classes Tutorial – ES6 Class Syntax, Inheritance & MoreJavaScript Constructor Functions – new Keyword, Prototype & OOP PatternsEncapsulation in JavaScript – Private Fields, Getters, Setters & Data ProtectionJavaScript Inheritance – extends, super, and Prototype-Based InheritanceObject-Oriented Programming in JavaScript – OOP Concepts Complete GuideJavaScript OOP Projects – Build Real-World Apps with Classes & OOPPolymorphism in JavaScript – Method Overriding, Duck Typing & Many FormsJavaScript Prototype Chain – How Property Lookup Works in JavaScriptJavaScript Prototypes – Prototype-Based Inheritance, Object.create & prototype PropertyJavaScript Advanced Practice Problems — 15+ Interview-Level Challenges 2026JavaScript Assignments — 10 Project-Based Learning Tasks 2026JavaScript Beginner Practice Problems — 20+ Coding Exercises 2026JavaScript Coding Challenges — 25 Interview-Style Problems 2026JavaScript Intermediate Practice Problems — 20+ Coding Challenges 2026JavaScript MCQs — 50 Multiple Choice Questions with Answers 2026JavaScript Regex Character Classes – [abc], [^abc], Ranges & ShortcutsJavaScript Regex Email Validation – Pattern, Edge Cases & Best PracticesJavaScript Regex Flags – g, i, m, s, u, y Flags Explained with ExamplesJavaScript Regex Groups – Capturing, Non-Capturing & Named GroupsJavaScript Number Validation with Regex — Complete Patterns & Examples 2026JavaScript Password Validation with Regex — Strength Checker & Patterns 2026JavaScript Regex Quantifiers – *, +, ?, {n,m}, Greedy vs Lazy MatchingJavaScript Regex Basics – Regular Expressions Tutorial for BeginnersJavaScript Regex Projects — 10 Practical Mini-Projects with Code 2026JavaScript URL Validation with Regex — Complete Patterns & Examples 2026JavaScript Username Validation with Regex — Patterns & Form Examples 2026JavaScript TutorialJavaScript Lazy Loading — Images, Modules & Components Complete Guide 2026JavaScript Performance Optimization — Speed Up Your Code Complete Guide 2026JavaScript Unit Testing with Jest — Complete Guide for Beginners 2026
Master JavaScript Promises from creation to advanced chaining patterns. Learn Promise states, resolve/reject, .then/.catch/.finally, microtask queue behavior, and real-world API patterns with fetch.
Introduction
A Promise is an object representing the eventual completion or failure of an asynchronous operation. Introduced in ES6 (2015), Promises solve the fundamental problems of callbacks: callback hell, inversion of control, and fragile error handling.
Think of a Promise like ordering food at a restaurant: you place your order (create a Promise), receive a receipt/ticket (the Promise object), and eventually either get your food (fulfilled) or learn it's unavailable (rejected). You don't stand at the kitchen waiting — you're free to do other things.
Promise States
A Promise is always in one of three states:
Example
┌─────────────────────────────────────────────────────────────┐
│ PROMISE LIFECYCLE │
│ │
│ ┌──────────┐ │
│ │ PENDING │ │
│ │ (initial │ │
│ │ state) │ │
│ └────┬─────┘ │
│ │ │
│ ┌──────────┴──────────┐ │
│ │ │ │
│ ▼ ▼ │
│ ┌────────────────┐ ┌────────────────┐ │
│ │ FULFILLED │ │ REJECTED │ │
│ │ (resolved) │ │ (error) │ │
│ │ │ │ │ │
│ │ Has a VALUE │ │ Has a REASON │ │
│ │ (.then runs) │ │ (.catch runs) │ │
│ └────────────────┘ └────────────────┘ │
│ │
│ ══════════════════════════════════════════════════════ │
│ Once settled (fulfilled or rejected), │
│ a Promise CANNOT change state again. │
│ ══════════════════════════════════════════════════════ │
└─────────────────────────────────────────────────────────────┘
- Pending: Initial state, operation in progress
- Fulfilled: Operation completed successfully, has a result value
- Rejected: Operation failed, has a reason (error)
- Settled: Either fulfilled or rejected (not pending)
Creating Promises
The Promise Constructor
Example
// Basic Promise creation
const myPromise = new Promise(function(resolve, reject) {
// This function is called the "executor"
// It runs IMMEDIATELY when the Promise is created
setTimeout(() => {
const success = true;
if (success) {
resolve("Operation completed!"); // Fulfills the promise
} else {
reject(new Error("Operation failed!")); // Rejects the promise
}
}, 1000);
});
// Consuming the promise
myPromise
.then(result => console.log("Success:", result))
.catch(error => console.error("Error:", error.message));
Output
Success: Operation completed!
The Executor Runs Immediately
Example
// IMPORTANT: The executor function runs synchronously!
console.log("1. Before Promise");
const promise = new Promise((resolve, reject) => {
console.log("2. Inside executor (runs immediately!)");
resolve("done");
});
console.log("3. After Promise creation");
promise.then(value => {
console.log("4. Then handler:", value);
});
console.log("5. After .then registration");
Output
1. Before Promise 2. Inside executor (runs immediately!) 3. After Promise creation 5. After .then registration 4. Then handler: done ← Microtask, runs after all sync code
Why does "5" print before "4"? The .then() handler is a microtask — it goes into the microtask queue and runs after all synchronous code completes.
Consuming Promises: .then(), .catch(), .finally()
.then() — Handle Fulfillment
Example
const promise = new Promise((resolve, reject) => {
setTimeout(() => resolve(42), 1000);
});
// Success handler
promise.then(value => {
console.log("Value:", value); // "Value: 42"
});
// .then() ALWAYS returns a new Promise
const promise2 = promise.then(value => {
return value * 2; // Return value becomes the next promise's resolved value
});
promise2.then(value => {
console.log("Doubled:", value); // "Doubled: 84"
});
Output
Value: 42 Doubled: 84
.catch() — Handle Rejection
Example
const failingPromise = new Promise((resolve, reject) => {
setTimeout(() => {
reject(new Error("Something went wrong!"));
}, 1000);
});
failingPromise.catch(error => {
console.error("Caught:", error.message); // "Caught: Something went wrong!"
});
// .catch() also returns a Promise - recovery is possible!
const recovered = failingPromise
.catch(error => {
console.log("Handling error:", error.message);
return "default value"; // Recovery value
})
.then(value => {
console.log("Recovered with:", value); // "Recovered with: default value"
});
Output
Caught: Something went wrong! Handling error: Something went wrong! Recovered with: default value
.finally() — Always Execute (Cleanup)
Example
function fetchUserData(userId) {
console.log("Loading...");
return fetch(`https://jsonplaceholder.typicode.com/users/${userId}`)
.then(response => {
if (!response.ok) throw new Error(`HTTP ${response.status}`);
return response.json();
})
.then(user => {
console.log("User:", user.name);
return user;
})
.catch(error => {
console.error("Failed:", error.message);
throw error; // Re-throw to keep the rejection
})
.finally(() => {
console.log("Loading complete (success or failure)");
// Hide loading spinner, re-enable button, etc.
});
}
fetchUserData(1);
Output
Loading... User: Leanne Graham Loading complete (success or failure)
Promise Chaining
The most powerful feature of Promises is chaining — each .then() returns a new Promise, allowing sequential async operations without nesting.
Basic Chaining
Example
fetch("https://jsonplaceholder.typicode.com/users/1")
.then(response => {
console.log("Status:", response.status);
return response.json(); // Returns a Promise!
})
.then(user => {
console.log("User:", user.name);
return fetch(`https://jsonplaceholder.typicode.com/posts?userId=${user.id}`);
})
.then(response => response.json())
.then(posts => {
console.log("Posts:", posts.length);
})
.catch(error => {
// Catches ANY error in the entire chain!
console.error("Chain error:", error.message);
});
Output
Status: 200 User: Leanne Graham Posts: 10
How Chaining Works Internally
Example
Promise Chain Flow:
────────────────────────────────────────────────────────
fetch(url)
│ Returns Promise<Response>
▼
.then(response => response.json())
│ response.json() returns Promise<Object>
│ .then() wraps it in a new Promise
▼
.then(data => transform(data))
│ Returns value → wrapped in resolved Promise
▼
.then(result => fetch(newUrl))
│ Returns Promise<Response> from fetch
▼
.then(response => response.json())
│ ...chain continues
▼
.catch(error => handleError(error))
│ If ANY promise in chain rejects,
│ execution jumps here, skipping .then()s
▼
.finally(() => cleanup())
│ Runs regardless
────────────────────────────────────────────────────────
Return Values in .then()
Example
// What you return from .then() determines the next Promise's value
// 1. Return a value → next .then() receives that value
Promise.resolve(1)
.then(val => val + 1) // returns 2
.then(val => val * 3) // returns 6
.then(val => console.log(val)); // 6
// 2. Return a Promise → next .then() waits for it
Promise.resolve("start")
.then(val => {
return new Promise(resolve => {
setTimeout(() => resolve(val + " → middle"), 1000);
});
})
.then(val => console.log(val)); // "start → middle" (after 1s)
// 3. Return nothing → next .then() receives undefined
Promise.resolve("hello")
.then(val => { console.log(val); }) // No return!
.then(val => console.log(val)); // undefined
// 4. Throw an error → jumps to .catch()
Promise.resolve("data")
.then(val => {
throw new Error("Oops!");
})
.catch(err => console.log("Caught:", err.message));
Output
6 start → middle hello undefined Caught: Oops!
Real-World Promise Examples
API Data Fetching with Full Error Handling
Example
async function loadUserDashboard(userId) {
return fetch(`https://jsonplaceholder.typicode.com/users/${userId}`)
.then(response => {
if (!response.ok) throw new Error(`HTTP ${response.status}`);
return response.json();
})
.then(user => {
console.log(`✅ User: ${user.name} (${user.email})`);
// Chain next request
return Promise.all([
user,
fetch(`https://jsonplaceholder.typicode.com/posts?userId=${userId}`).then(r => r.json()),
fetch(`https://jsonplaceholder.typicode.com/todos?userId=${userId}`).then(r => r.json())
]);
})
.then(([user, posts, todos]) => {
console.log(`✅ Posts: ${posts.length}`);
console.log(`✅ Todos: ${todos.length} (${todos.filter(t => t.completed).length} done)`);
return { user, posts, todos };
})
.catch(error => {
console.error("❌ Dashboard failed:", error.message);
return null;
})
.finally(() => {
console.log("Dashboard load attempt finished");
});
}
loadUserDashboard(1);
Output
✅ User: Leanne Graham (Sincere@april.biz) ✅ Posts: 10 ✅ Todos: 20 (11 done) Dashboard load attempt finished
Promise Error Propagation
Understanding how errors travel through a Promise chain is critical:
Example
Promise.resolve("start")
.then(val => {
console.log("Step 1:", val);
return "step1 result";
})
.then(val => {
console.log("Step 2:", val);
throw new Error("Error at step 2!"); // ← Error injected here
})
.then(val => {
console.log("Step 3:", val); // ← SKIPPED
})
.then(val => {
console.log("Step 4:", val); // ← SKIPPED
})
.catch(error => {
console.log("Caught:", error.message); // ← Runs here
return "recovered"; // ← Recovery - continues the chain
})
.then(val => {
console.log("Step 5 (after recovery):", val); // ← Runs!
});
Output
Step 1: start Step 2: step1 result Caught: Error at step 2! Step 5 (after recovery): recovered
Example
Error Flow in Promise Chain:
─────────────────────────────────────────────────────
.then() step 1 ✅ runs
.then() step 2 ✅ runs, then throws error
.then() step 3 ⏭️ SKIPPED (error propagating)
.then() step 4 ⏭️ SKIPPED (error propagating)
.catch() ✅ catches error, returns "recovered"
.then() step 5 ✅ runs with "recovered"
─────────────────────────────────────────────────────
Creating Utility Promise Functions
promisify — Convert Callbacks to Promises
Example
// Generic promisify utility
function promisify(fn) {
return function(...args) {
return new Promise((resolve, reject) => {
fn(...args, (error, result) => {
if (error) reject(error);
else resolve(result);
});
});
};
}
// Simulated callback-based function
function readFile(path, callback) {
setTimeout(() => {
if (path === "missing.txt") {
callback(new Error("File not found"), null);
} else {
callback(null, `Contents of ${path}`);
}
}, 500);
}
// Convert to Promise-based
const readFilePromise = promisify(readFile);
readFilePromise("data.txt")
.then(content => console.log("Content:", content))
.catch(error => console.error("Error:", error.message));
readFilePromise("missing.txt")
.then(content => console.log("Content:", content))
.catch(error => console.error("Error:", error.message));
Output
Content: Contents of data.txt Error: File not found
Promise.resolve() and Promise.reject()
Example
// Create immediately resolved/rejected Promises
const resolved = Promise.resolve(42);
const rejected = Promise.reject(new Error("Instant failure"));
resolved.then(val => console.log("Resolved:", val)); // "Resolved: 42"
rejected.catch(err => console.log("Rejected:", err.message)); // "Rejected: Instant failure"
// Useful for normalizing values
function getUser(id) {
if (id === 0) {
return Promise.resolve({ id: 0, name: "Guest" }); // No async needed!
}
return fetch(`https://jsonplaceholder.typicode.com/users/${id}`)
.then(r => r.json());
}
getUser(0).then(user => console.log("User:", user.name));
getUser(1).then(user => console.log("User:", user.name));
Output
Resolved: 42 Rejected: Instant failure User: Guest User: Leanne Graham
Common Mistakes ⚠️
Mistake 1: Not Returning from .then()
Example
// ❌ Wrong: forgot to return the inner Promise
fetch("https://jsonplaceholder.typicode.com/users/1")
.then(response => {
response.json(); // Missing return! Next .then() gets undefined
})
.then(user => {
console.log(user); // undefined — not the user object!
});
// ✅ Correct: always return
fetch("https://jsonplaceholder.typicode.com/users/1")
.then(response => response.json()) // ← return the Promise
.then(user => console.log(user.name));
Mistake 2: Nesting Promises Instead of Chaining
Example
// ❌ Wrong: Promise pyramid (same as callback hell!)
fetch("https://jsonplaceholder.typicode.com/users/1")
.then(response => {
return response.json().then(user => { // ← Nested!
return fetch(`/posts?userId=${user.id}`).then(r => { // ← More nesting!
return r.json().then(posts => { // ← Even more!
console.log(posts.length);
});
});
});
});
// ✅ Correct: flatten with chaining
fetch("https://jsonplaceholder.typicode.com/users/1")
.then(response => response.json())
.then(user => fetch(`https://jsonplaceholder.typicode.com/posts?userId=${user.id}`))
.then(response => response.json())
.then(posts => console.log(posts.length));
Mistake 3: Forgetting .catch()
Example
// ❌ Wrong: Unhandled rejection warning
fetch("https://invalid-url-xyz.com/data")
.then(r => r.json())
.then(data => console.log(data));
// UnhandledPromiseRejectionWarning!
// ✅ Correct: Always chain a .catch()
fetch("https://invalid-url-xyz.com/data")
.then(r => r.json())
.then(data => console.log(data))
.catch(error => console.error("Network error:", error.message));
Mistake 4: Creating Promises Unnecessarily
Example
// ❌ Anti-pattern: Wrapping a Promise in another Promise
function fetchUser(id) {
return new Promise((resolve, reject) => { // ← Unnecessary!
fetch(`https://jsonplaceholder.typicode.com/users/${id}`)
.then(r => r.json())
.then(resolve)
.catch(reject);
});
}
// ✅ Correct: Just return the fetch Promise
function fetchUser(id) {
return fetch(`https://jsonplaceholder.typicode.com/users/${id}`)
.then(r => r.json());
}
Interview Questions 🎯
Q1. What is a Promise in JavaScript?
A Promise is an object representing the eventual completion or failure of an asynchronous operation. It has three states: pending (initial), fulfilled (success), and rejected (failure). Once settled, a Promise cannot change state. Promises were introduced in ES6 to solve callback hell and provide better error handling.
Q2. What are the three states of a Promise?
Pending: Initial state, the async operation is in progress. Fulfilled: The operation completed successfully — the Promise has a value and.then()handlers run. Rejected: The operation failed — the Promise has an error reason and.catch()handlers run. Together, fulfilled and rejected are called "settled."
Q3. What is the difference between .then() and .catch()?
.then(onFulfilled, onRejected)handles both success and failure..catch(onRejected)is shorthand for.then(null, onRejected)— it handles only rejections. Using.catch()at the end of a chain catches any rejection in the entire chain, not just the last step.
Q4. What does .finally() do?
.finally(callback) executes the callback regardless of whether the Promise fulfilled or rejected. It doesn't receive the value/error as an argument. Perfect for cleanup: hiding loading spinners, closing database connections, re-enabling buttons.Q5. What is Promise chaining?
Since.then()always returns a new Promise, you can chain multiple.then()calls. Each returns a new Promise whose value is whatever is returned from the handler. This creates flat, readable sequential async code without nesting.
Q6. When does a .then() handler run? Synchronously or asynchronously?
Always asynchronously — even for already-settled Promises. .then() callbacks go into the microtask queue and run after all synchronous code completes. This ensures consistent behavior regardless of whether the Promise resolved synchronously or asynchronously.Q7. What is an "unhandled promise rejection"?
When a Promise is rejected but has no.catch()handler (or.then(null, onRejected)) attached, it becomes an unhandled rejection. Modern environments throw warnings or errors for this. In Node.js 15+, it crashes the process. Always attach.catch()to Promise chains.
Q8. What's the difference between Promise.resolve(value) and new Promise((resolve) => resolve(value))?
They're equivalent in behavior — both create an immediately-resolved Promise.Promise.resolve(value)is a shorthand factory method. Use it when you need to normalize a value: ifvalueis already a Promise,Promise.resolve()returns it as-is; if it's a plain value, it wraps it.
Key Takeaways 📌
- A Promise is a placeholder for a future value — always pending, fulfilled, or rejected
- The executor function runs synchronously;
.then()callbacks run as microtasks .then()always returns a new Promise — this enables chaining- Chain
.then()calls for sequential operations; never nest them - Always add
.catch()at the end of chains — unhandled rejections are serious bugs .finally()runs after success OR failure — perfect for cleanup- Return Promises from
.then()to chain properly — the chain waits for nested Promises Promise.resolve()andPromise.reject()create instantly-settled Promises
Exam Focus
Revise definitions, diagrams, examples, and short-answer points for JavaScript Promises - Complete Guide with Chaining, Error Handling & Event Loop.
Interview Use
Prepare one clear explanation, one practical example, and one common mistake for this JavaScript Master Course topic.
Search Terms
javascript-complete-guide, javascript master course, javascript, complete, guide, asynchronous, promises, javascript promises - complete guide with chaining, error handling & event loop
Related JavaScript Master Course Topics
Continue learning this concept
Asynchronous JavaScriptJavaScript Async Await - Complete Guide with Examples & Error HandlingMaster JavaScript async/await syntax, error handling with try/catch, sequential vs parallel execution, and real-world API patterns. Complete guide with diagrams.Asynchronous JavaScriptJavaScript Call Stack - Complete Guide with Visual Diagrams & ExamplesUnderstand JavaScriptAsynchronous JavaScriptJavaScript Callback Queue (Task Queue) - Complete Guide with DiagramsMaster JavaScriptAsynchronous JavaScriptJavaScript Callbacks - Complete Guide with Callback Hell & PatternsMaster JavaScript callbacks from basics to advanced patterns. Learn callback functions, higher-order functions, callback hell, error-first callbacks, and how callbacks interact with the event loop and task queues.Asynchronous JavaScriptJavaScript Event Loop - Complete Guide with Visual Diagrams & ExamplesMaster JavaScriptAsynchronous JavaScriptJavaScript Fetch API - Complete Guide with Examples, Error Handling & Async/AwaitMaster JavaScript