JavaScript, through its popularity and recent improvements, is increasingly becoming the web programmer's best friend. And like all best friends, JavaScript keeps its promises.
Now that may sound a little strange, but it's true. Most current browsers support what is called the Promise object. A promise is quite like a function in that it represents a piece of code or a task that you would like to be executed at some point in the future.
Here's what a promise looks like.
var myPromise = new Promise(function (resolve, reject) {
// Task to carry out goes here.
});You can see here that when we create a promise we give it a single argument, which is a function containing code that we would like to execute at some point in the future. You may have also have noticed the two arguments in the function passed to the promise, resolve and reject. These are also functions and are our way of telling the Promise whether it has done what it promised to do. This is how you would use them:
var myPromise = new Promise(function (resolve, reject) {
if (true) {
resolve('Hello Tuts+ fans!');
} else {
reject('Aww, didn\'t work.');
}
});This promise is obviously always going to resolve as the if statement will always be true. This is just for learning purposes—we'll do something more realistic later on—but imagine replacing the true with a snippet of code that you weren't 100% sure was going to work.
Now that we've created a promise, how do we use it? Well, we need to tell it what those resolve and reject functions are. We do this by using the promise's then method.
myPromise.then(function (result) {
// Resolve callback.
console.log(result);
}, function (result) {
// Reject callback.
console.error(result);
});Because our if statement is always passing its true check, the above code will always log "Hello Tuts+ fans!" to the console. It will also do it immediately. This is because the code inside our Promise's constructor is synchronous, meaning that it isn't waiting on any operation to execute. It has all the information it needs to continue and does so as soon as possible.
Where promises really shine, though, is when it comes to asynchronous tasks—tasks where you don't know when exactly the promise will be fulfilled. A real-world example of an asynchronous task is fetching a resource, like a JSON file for instance, via AJAX. We don't know how long the server is going to take to respond, and it may even fail. Let's add in some AJAX to our promise code.
var myPromise = new Promise(function (resolve, reject) {
// Standard AJAX request setup and load.
var request = new XMLHttpRequest();
// Request a user's comment from our fake blog.
request.open('GET', 'http://jsonplaceholder.typicode.com/posts/1');
// Set function to call when resource is loaded.
request.onload = function () {
if (request.status === 200) {
resolve(request.response);
} else {
reject('Page loaded, but status not OK.');
}
};
// Set function to call when loading fails.
request.onerror = function () {
reject('Aww, didn\'t work at all.');
}
request.send();
});The code here is just standard JavaScript for performing an AJAX request. We request a resource, in this case a JSON file at a specified URL, and wait for it to respond. We'll never know exactly when. And we obviously don't want to halt the execution of out script to wait for it, so what do we do?
Well, luckily we've put this code inside a promise. By putting it here, we're basically saying, "Hey piece of code, I've got to go just now but I'll give you a call later and tell you when to execute. Promise you'll do it and tell me when you're done?" And the code will say, "Yes, of course. I promise."
An important thing to note in the above piece of code is the calling of the resolve and reject functions. Remember, these are our way of telling our promise that our code has or hasn't executed successfully. Otherwise, we'll never know.
Using the same code from our basic example, we can see how our AJAX request inside the promise will now work.
// Tell our promise to execute its code
// and tell us when it's done.
myPromise.then(function (result) {
// Prints received JSON to the console.
console.log(result);
}, function (result) {
// Prints "Aww didn't work" or
// "Page loaded, but status not OK."
console.error(result);
});I knew we could trust you, myPromise.
Now, you may be thinking at this point that promises are just fancy callback functions with a nicer syntax. That's true to a degree, but to continue with our AJAX example, say you needed to make few more requests, each request based on the result of the last. Or what if you needed to process the JSON first?
Doing this with callbacks would end in heavy nesting of functions, each one becoming increasingly difficult to keep track of. Luckily, in the world of promises we can chain such functions together like so. Here's an example where once we receive the JSON for a user's comment on our fake blog, then we want to make sure it's all lowercase before doing something else with it.
myPromise
.then(function (result) {
// Once we receive JSON,
// turn it into a JSON object and return.
return JSON.parse(result);
})
.then(function (parsedJSON) {
// Once json has been parsed,
// get the email address and make it lowercase.
return parsedJSON.email.toLowerCase();
})
.then(function (emailAddress) {
// Once text has been made lowercase,
// print it to the console.
console.log(emailAddress);
}, function (err) {
// Something in the above chain went wrong?
// Print reject output.
console.error(err);
});You can see here that while our initial call was asynchronous, it's possible to chain synchronous calls too. The code in each resolve function inside the then will be called when each one returns. You'll also notice that there is only one error function specified here for the whole chain. By placing this at the end of the chain as the reject function in the last then, any promise in the chain that calls reject will call this one.
Now that we're a bit more confident with promises, let's create another one in conjunction with the one above. We'll create one that takes our new lowercase email address and will (pretend to) send an email to that address. This is just an example to illustrate something asynchronous—it could be anything, like contacting a server to see if the email was on a whitelist or if the user is logged in. We'll need to give the email address to the new promise, but promises don't accept arguments. The way to get around this is to wrap the promise in a function that does, like so:
var sendEmail = function (emailAddress) {
return new Promise(function (resolve, reject) {
// Pretend to send an email
// or do something else asynchronous
setTimeout(function () {
resolve('Email sent to ' + emailAddress);
}, 3000);
});
};We're using the setTimeout call here to simply fake a task that takes a few seconds to run asynchronously.
So how do we use our new promise-creating function? Well, since each resolve function used within a then should return a function, then we can use it in a similar way to our synchronous tasks.
myPromise
.then(function (result) {
return JSON.parse(result);
})
.then(function (parsedJSON) {
return parsedJSON.email.toLowerCase();
})
.then(function (emailAddress) {
return sendEmail(emailAddress)
})
.then(function (result) {
// Outputs "Email sent to stuart@fakemail.biz"
console.log(result);
}, function (err) {
console.error(err);
});Let's go over this flow just to summarise what's going on. Our original promise myPromise requests a piece of JSON. When that JSON is received (we don't know when), we turn the JSON into a JavaScript object and return that value.
Once that's done, we take the email address out of the JSON and make it lowercase. Then we send an email to that address, and again we don't know when it's going to complete, but when it does we'll output a success message to the console. No heavy nesting in sight.
I hope this has been a useful introduction to Promises, and has given you good reason to start using them in your JavaScript projects. If you want to learn more about Promises in greater detail, check out Jake Archibald's excellent HTML5 Rocks article on this very subject.
The Best Small Business Web Designs by DesignRush
/
-1Create Modern Vue Apps Using Create-Vue and Vite
/
4Pros and Cons of Using WordPress
/
-4How to Fix the “There Has Been a Critical Error in Your Website” Error in WordPress
/
2How To Fix The “There Has Been A Critical Error in Your Website” Error in WordPress
How to Create a Privacy Policy Page in WordPress
/
8WordPress Website Maintenance Guide For Beginners
/
6How Long Does it Take to Learn JavaScript
/
1The Best Way to Deep Copy an Object in JavaScript
/
-2
3
-6Adding and Removing Elements From Arrays in JavaScript
/
-2Create a JavaScript AJAX Post Request: With and Without jQuery
/
85 Real-Life Uses for the JavaScript reduce() Method
/
-11How to Enable or Disable a Button With [removed] jQuery vs. Vanilla
/
2How to Enable or Disable a Button With [removed] jQuery vs Vanilla
/
-4Confirm Yes or No With JavaScript
/
-2How to Change the URL in [removed] Redirecting
/
-315+ Best WordPress Twitter Widgets
/
-227 Best Tab and Accordion Widget Plugins for WordPress (Free & Premium)
/
1021 Best Tab and Accordion Widget Plugins for WordPress (Free & Premium)
/
-1130 HTML Best Practices for Beginners
/
-831 Best WordPress Calendar Plugins and Widgets (With 5 Free Plugins)
/
425 Ridiculously Impressive HTML5 Canvas Experiments
/
-6
1How to Implement Email Verification for New Members
/
2How to Create a Simple Web-Based Chat Application
/
530 Popular WordPress User Interface Elements
/
-5Top 18 Best Practices for Writing Super Readable Code
/
2Best Affiliate WooCommerce Plugins Compared
/
-1018 Best WordPress Star Rating Plugins
/
1510+ Best WordPress Twitter Widgets
/
420+ Best WordPress Booking and Reservation Plugins
/
4Working With Tables in React: Part Two
/
-4Best CSS Animations and Effects on CodeCanyon
/
-1630 CSS Best Practices for Beginners
/
4How to Create a Custom WordPress Plugin From Scratch
/
610 Best Responsive HTML5 Sliders for Images and Text… and 3 Free Options
/
-416 Best Tab and Accordion Widget Plugins for WordPress
/
-418 Best WordPress Membership Plugins and 5 Free Plugins
/
325 Best WooCommerce Plugins for Products, Pricing, Payments and More
/
310 Best WordPress Twitter Widgets
1 /
1512 Best Contact Form PHP Scripts for 2020
/
-420 Popular WordPress User Interface Elements
/
-210 Best WordPress Star Rating Plugins
/
-312 Best CSS Animations on CodeCanyon
/
112 Best WordPress Booking and Reservation Plugins
/
220 Best WordPress Calendar Plugins and Widgets
/
-112 Elegant CSS Pricing Tables for Your Latest Web Project
/
724 Best WordPress Form Plugins for 2020
/
-214 Best PHP Event Calendar and Booking Scripts
/
-2Create a Blog for Each Category or Department in Your WooCommerce Store
/
38 Best WordPress Booking and Reservation Plugins
/
-18Best Exit Popups for WordPress Compared
/
20Best Exit Popups for WordPress Compared
/
-711 Best Tab & Accordion WordPress Widgets & Plugins
/
-1112 Best Tab & Accordion WordPress Widgets & Plugins
1 /
1New Course: Practical React Fundamentals
/
2Short Course: Better Angular App Architecture With Modules
/
2Preview Our New Course on Angular Material
/
5Build Your Own CAPTCHA and Contact Form in PHP
/
-1Object-Oriented PHP With Classes and Objects
/
2Best Practices for ARIA Implementation
/
-4Accessible Apps: Barriers to Access and Getting Started With Accessibility
/
-3Dramatically Speed Up Your React Front-End App Using Lazy Loading
/
1915 Best Modern JavaScript Admin Templates for React, Angular, and Vue.js
/
-1515 Best Modern JavaScript Admin Templates for React, Angular and Vue.js
/
319 Best JavaScript Admin Templates for React, Angular, and Vue.js
/
3New Course: Build an App With JavaScript and the MEAN Stack
/
10Hands-on With ARIA: Accessibility Recipes for Web Apps
/
910 Best WordPress Facebook Widgets
13 /
-5Hands-on With ARIA: Accessibility for eCommerce
/
6New eBooks Available for Subscribers
/
-5Hands-on With ARIA: Homepage Elements and Standard Navigation
/
9
-8Site Accessibility: Getting Started With ARIA
/
5New Course: Secure Your WordPress Site With SSL
/
-3Testing Components in React Using Jest and Enzyme
/
-9Testing Components in React Using Jest: The Basics
/
-515 Best PHP Event Calendar and Booking Scripts
/
-1Create Interactive Gradient Animations Using Granim.js
/
11How to Build Complex, Large-Scale Vue.js Apps With Vuex
1Examples of Dependency Injection in PHP With Symfony Components
/
-6Set Up Routing in PHP Applications Using the Symfony Routing Component
1 /
12A Beginner’s Guide to Regular Expressions in JavaScript
/
13Introduction to Popmotion: Custom Animation Scrubber
/
-6Introduction to Popmotion: Pointers and Physics
/
-10New Course: Connect to a Database With Laravel’s Eloquent ORM
/
-4How to Create a Custom Settings Panel in WooCommerce
/
-13Building the DOM faster: speculative parsing, async, defer and preload
1 /
220 Useful PHP Scripts Available on CodeCanyon
3 /
50How to Find and Fix Poor Page Load Times With Raygun
/
1Introduction to the Stimulus Framework
/
-14Single-Page React Applications With the React-Router and React-Transition-Group Modules
/
1
712 Best Contact Form PHP Scripts
1 /
-4Getting Started With the Mojs Animation Library: The ShapeSwirl and Stagger Modules
/
3Getting Started With the Mojs Animation Library: The Shape Module
/
-4Getting Started With the Mojs Animation Library: The HTML Module
/
4Project Management Considerations for Your WordPress Project
/
-88 Things That Make Jest the Best React Testing Framework
/
3Creating an Image Editor Using CamanJS: Layers, Blend Modes, and Events
/
-3New Short Course: Code a Front-End App With GraphQL and React
Creating an Image Editor Using CamanJS: Applying Basic Filters
/
-13Creating an Image Editor Using CamanJS: Creating Custom Filters and Blend Modes
Modern Web Scraping With BeautifulSoup and Selenium
/
1Challenge: Create a To-Do List in React
1 /
1Deploy PHP Web Applications Using Laravel Forge
/
-2Getting Started With the Mojs Animation Library: The Burst Module
/
5
-910 Things Men Can Do to Support Women in Tech
/
1A Gentle Introduction to Higher-Order Components in React: Best Practices
/
-4Challenge: Build a React Component
/
-4A Gentle Introduction to HOC in React: Learn by Example
/
5A Gentle Introduction to Higher-Order Components in React
/
-7Creating Pretty Popup Messages Using SweetAlert2
/
4Creating Stylish and Responsive Progress Bars Using ProgressBar.js
/
1718 Best Contact Form PHP Scripts for 2022
/
-3Creating a Blogging App Using Angular & MongoDB: Delete Post
/
-17Set Up an OAuth2 Server Using Passport in Laravel
/
1Creating a Blogging App Using Angular & MongoDB: Edit Post
/
-2Creating a Blogging App Using Angular & MongoDB: Add Post
/
-1Introduction to Mocking in Python
/
-1Creating a Blogging App Using Angular & MongoDB: Show Post
/
8Creating a Blogging App Using Angular & MongoDB: Home
/
10
2Creating a Blogging App Using Angular & MongoDB: Login
/
14Creating Your First Angular App: Implement Routing
/
12Persisted WordPress Admin Notices: Part 4
/
-5Creating Your First Angular App: Components, Part 2
/
3Persisted WordPress Admin Notices: Part 3
/
3Creating Your First Angular App: Components, Part 1
/
1How Laravel Broadcasting Works
/
1
9Persisted WordPress Admin Notices: Part 2
/
-3Create Your First Angular App: Storing and Accessing Data
/
2Persisted WordPress Admin Notices: Part 1
/
-4Error and Performance Monitoring for Web & Mobile Apps Using Raygun
/
6Using Luxon for Date and Time in JavaScript
7 /
-7How to Create an Audio Oscillator With the Web Audio API
/
-5How to Cache Using Redis in Django Applications
/
220 Essential WordPress Utilities to Manage Your Site
/
-5Introduction to API Calls With React and Axios
/
18Beginner’s Guide to Angular 4: HTTP
/
12Rapid Web Deployment for Laravel With GitHub, Linode, and RunCloud.io
/
8Beginners Guide to Angular 4: Routing
/
-9Beginner’s Guide to Angular 4: Services
/
-1Beginner’s Guide to Angular 4: Components
/
2Creating a Drop-Down Menu for Mobile Pages
/
4Introduction to Forms in Angular 4: Writing Custom Form Validators
/
510 Best WordPress Booking & Reservation Plugins
/
2Getting Started With Redux: Connecting Redux With React
/
16Getting Started With Redux: Learn by Example
/
16Getting Started With Redux: Why Redux?
/
9Understanding Recursion With JavaScript
/
-2How to Auto Update WordPress Salts
/
-8How to Download Files in Python
/
-4
-22Eloquent Mutators and Accessors in Laravel
1 /
16
-11
1110 Best HTML5 Sliders for Images and Text
/
6Site Authentication in Node.js: User Signup
/
-4Creating a Task Manager App Using Ionic: Part 2
/
2Creating a Task Manager App Using Ionic: Part 1
/
2
3Introduction to Forms in Angular 4: Template-Driven Forms
/
-224 Essential WordPress Utilities to Manage Your Site
/
-125 Essential WordPress Utilities to Manage Your Site
/
-12Get Rid of Bugs Quickly Using BugReplay
1 /
-15Manipulating HTML5 Canvas Using Konva: Part 1, Getting Started
/
710 Must-See Easy Digital Downloads Extensions for Your WordPress Site
22 Best WordPress Booking and Reservation Plugins
/
-6Understanding ExpressJS Routing
/
-515 Best WordPress Star Rating Plugins
/
12Creating Your First Angular App: Basics
/
-1Inheritance and Extending Objects With JavaScript
/
-8Introduction to the CSS Grid Layout With Examples
1 /
1
8Performant Animations Using KUTE.js: Part 5, Easing Functions and Attributes
/
-9Performant Animations Using KUTE.js: Part 4, Animating Text
/
-14Performant Animations Using KUTE.js: Part 3, Animating SVG
/
-9New Course: Code a Quiz App With Vue.js
/
-1Performant Animations Using KUTE.js: Part 2, Animating CSS Properties
/
3
8Performant Animations Using KUTE.js: Part 1, Getting Started
/
310 Best Responsive HTML5 Sliders for Images and Text (Plus 3 Free Options)
/
-3Single-Page Applications With ngRoute and ngAnimate in AngularJS
/
-12Deferring Tasks in Laravel Using Queues
/
-4
3Site Authentication in Node.js: User Signup and Login
/
11Working With Tables in React, Part Two
/
-16Working With Tables in React, Part One
/
6How to Set Up a Scalable, E-Commerce-Ready WordPress Site Using ClusterCS
/
-2New Course on WordPress Conditional Tags
/
4TypeScript for Beginners, Part 5: Generics
/
1
-11Building With Vue.js 2 and Firebase
6 /
10
-9Best Unique Bootstrap JavaScript Plugins
/
-9
-6Essential JavaScript Libraries and Frameworks You Should Know About
/
7
3Vue.js Crash Course: Create a Simple Blog Using Vue.js
/
-13Build a React App With a Laravel RESTful Back End: Part 1, Laravel 5.5 API
/
3API Authentication With Node.js
/
-4Beginner’s Guide to Angular: HTTP
/
7Beginner’s Guide to Angular: Routing
/
-4Beginners Guide to Angular: Routing
/
-6Beginner’s Guide to Angular: Services
/
4Beginner’s Guide to Angular: Components
/
-1How to Create a Custom Authentication Guard in Laravel
/
7Learn Computer Science With [removed] Part 3, Loops
/
-2Build Web Applications Using Node.js
/
1Learn Computer Science With [removed] Part 4, Functions
/
4Learn Computer Science With [removed] Part 2, Conditionals
/
12Learn Computer Science With [removed] Part 1, The Basics
/
-5Create Interactive Charts Using Plotly.js, Part 5: Pie and Gauge Charts
/
-10Create Interactive Charts Using Plotly.js, Part 4: Bubble and Dot Charts
/
18Create Interactive Charts Using Plotly.js, Part 3: Bar Charts
/
-13Awesome JavaScript Libraries and Frameworks You Should Know About
/
-4Create Interactive Charts Using Plotly.js, Part 2: Line Charts
/
-8Bulk Import a CSV File Into MongoDB Using Mongoose With Node.js
/
-4Build a To-Do API With Node, Express, and MongoDB
/
-6Getting Started With End-to-End Testing in Angular Using Protractor
/
10TypeScript for Beginners, Part 4: Classes
/
-10Object-Oriented Programming With JavaScript
/
610 Best Affiliate WooCommerce Plugins Compared
/
9Stateful vs. Stateless Functional Components in React
/
11Make Your JavaScript Code Robust With Flow
/
-6Build a To-Do API With Node and Restify
/
8Testing Components in Angular Using Jasmine: Part 2, Services
/
2Testing Components in Angular Using Jasmine: Part 1
/
-2Creating a Blogging App Using React, Part 6: Tags
/
-12React Crash Course for Beginners, Part 3
/
3React Crash Course for Beginners, Part 2
/
11React Crash Course for Beginners, Part 1
/
3Set Up a React Environment, Part 4
1 /
8Set Up a React Environment, Part 3
/
-11New Course: Get Started With Phoenix
/
-11Set Up a React Environment, Part 2
/
2Command Line Basics and Useful Tricks With the Terminal
/
5How to Create a Real-Time Feed Using Phoenix and React
/
-8Build a React App With a Laravel Back End: Part 2, React
/
1Build a React App With a Laravel RESTful Back End: Part 1, Laravel 9 API
/
-7Creating a Blogging App Using React, Part 5: Profile Page
/
-5Pagination in CodeIgniter: The Complete Guide
/
22JavaScript-Based Animations Using Anime.js, Part 4: Callbacks, Easings, and SVG
/
-1JavaScript-Based Animations Using Anime.js, Part 3: Values, Timeline, and Playback
/
1Learn to Code With [removed] Part 1, The Basics
/
510 Elegant CSS Pricing Tables for Your Latest Web Project
/
-7Getting Started With the Flux Architecture in React
/
-3Getting Started With Matter.js: The Composites and Composite Modules
/
5Getting Started With Matter.js: The Engine and World Modules
/
1310 More Popular HTML5 Projects for You to Use and Study
/
-24Understand the Basics of Laravel Middleware
/
-6Iterating Fast With Django & Heroku
/
8Creating a Blogging App Using React, Part 4: Update & Delete Posts
/
2Creating a jQuery Plugin for Long Shadow Design
/
-9How to Register & Use Laravel Service Providers
2 /
-13Unit Testing in React: Shallow vs. Static Testing
/
6Creating a Blogging App Using React, Part 3: Add & Display Post
/
15Creating a Blogging App Using React, Part 2: User Sign-Up
20 /
-5Creating a Blogging App Using React, Part 1: User Sign-In
/
99 More Popular HTML5 Projects for You to Use and Study
/
18Creating a Grocery List Manager Using Angular, Part 2: Managing Items
/
99 Elegant CSS Pricing Tables for Your Latest Web Project
/
1Dynamic Page Templates in WordPress, Part 3
/
-2Angular vs. React: 7 Key Features Compared
/
6Creating a Grocery List Manager Using Angular, Part 1: Add & Display Items
/
2New eBooks Available for Subscribers in June 2017
/
7Create Interactive Charts Using Plotly.js, Part 1: Getting Started
/
11The 5 Best IDEs for WordPress Development (And Why)
/
233 Popular WordPress User Interface Elements
/
2New Course: How to Hack Your Own App
/
-10How to Install Yii on Windows or a Mac
/
5What Is a JavaScript Operator?
/
-5How to Register and Use Laravel Service Providers
/
7
waly Good blog post. I absolutely love this…