Cloudinary Blog

Lazy-Loading JavaScript for High-Speed Webpage Performance

 Lazy-Loading JavaScript for High-Speed Webpage Performance

JavaScript is a popular programming language, typically for building interactive web apps, thanks to its ease of use and ability to run in any browser with no "JavaScript turned off" setting. The language is easy to learn, accelerating app development. However, to avoid performance issues, be sure to optimize your JavaScript apps for media loading. You can do that by adopting techniques for optimizing website images, such as lazy loading.

This post addresses the following topics:

How to Optimize for Page Load Speed

What Is JavaScript?

JavaScript (JS) is multiparadigm, i.e., ideal for procedural, functional, and object-oriented programming. Originally designed for the client side only, JS is increasingly being used on the server side as the back-end for websites and web apps through frameworks, such as Node.js.

Why Are JavaScript Libraries Widely Used?

For efficiency, in addition to using libraries when developing back-end APIs, many JS programmers leverage frameworks, which offer convenient shortcuts for common capabilities and methods. Frameworks help standardize programming and can significantly boost productivity.

Part of what makes frameworks easy to use in JS is its huge user base, which works with many tools. The most popular frameworks have extensive documentation, robust communities, lots of illuminating dialog on implementation, and tips and suggestions for best practices. Additionally, strong community support means that bugs and security issues tend to be found and fixed quickly.

What Is Lazy Loading?

Lazy loading is a practice that delays the initialization of web elements, e.g., you can prevent a video at the bottom of a page from loading until the viewer has clicked the Play button or scrolled over there.

Lazy loading improves web performance and can help you avoid the following pitfalls:

  • Page lag created by multiple synchronous requests for content.
  • Longer load times due to large content files.
  • Loss of users due to poor site performance, which is especially problematic in case of slow Internet connections.
  • Bandwidth waste caused by loaded but unviewed content.

To head off those issues, most modern browsers support lazy loading. Notably, Google Chrome 76 and higher support lazy loading natively with a loading attribute that enables you to defer loading of offscreen images with no additional code. For browsers in which lazy loading doesn’t work, you can often implement it by means of libraries or polyfills with an associated API.

What Is the Intersection Observer API?

The Intersection Observer API is a built-in browser tool for manipulating elements on websites and in applications by asynchronously monitoring the intersection of elements with the viewer’s viewport or other elements. With that API, you can—

  • Lazy-load content as the viewer scrolls through your page.
  • Implement “infinite scrolling,” such as that in Instagram and many forums.
  • Determine and report on the visibility of ads for revenue analysis or user-experience studies.
  • Reduce resource consumption by withholding tasks or animations until they are relevant for the viewer.

To use Intersection Observer, first create a callback, which can be triggered by an element that intersects with a specified element or the viewport. Often, the intersection is with an element’s closest scrollable ancestor. The following code shows a callback with options for intersection elements.

Copy to clipboard
let callback = (entries, observer) => {
  entries.forEach(entry => {
    // Each entry describes an intersection change for one observed
    // target element:
    //   entry.boundingClientRect
    //   entry.intersectionRatio
    //   entry.intersectionRect
    //   entry.isIntersecting
    //   entry.rootBounds
    //   entry.time

When defining this intersection, you can specify the overlap, i.e., how close the content is to being accessed. Alternatively, trigger it the first time an event, such as a button click, occurs.

Can You Simplify the Lazy-Loading Process?

You can simplify lazy loading with libraries. Below are two examples.

  • Lozad.js is an open-source, lightweight library for configuring lazy loading of images, iframes, video, and audio. Based on the Intersection Observer API, Lozad.js adds no dependencies to your projects. You can use it with either static or dynamically loaded elements.

    To install Lozad.js, type:

    Copy to clipboard
    $ npm install --save lozad


    Copy to clipboard
    $ yarn add lozad
  • Yall.js is also an open-source library for configuring lazy loading of various media, including <img>, <picture>, <video>, and <iframe> elements; and CSS background images. Yall.js works with not only JS but also with the <noscript> tag. Based on the Intersection Observer API, Yall.js can monitor changes in the Document Object Model (DOM) with Mutation Observer.

    To install Yall.js, type:

    Copy to clipboard
    npm install yall-js

How Do You Lazy-Load in JavaScript with Intersection Observer?

Below is a simplified tutorial on how to implement lazy loading with Intersection Observer. For more details, see the full tutorial by Chidume Nnamdi.

  1. Define the `image` tag with lazy-load attributes.

    Define the `image` tag with a shared class that identifies lazy-loaded images, e.g., `lzy_img`. That tag must contain two attributes:

    • The regular `src` attribute, which refers to the original image.
    • The `data-src` attribute, which refers to the image shown after lazy loading.
    See this example:
    Copy to clipboard
    <img class="lzy_img" src="lazy_img.jpg" data-src="real_img.jpg" />
  2. Instantiate Intersection Observer.

    First, create an instance of the Intersection Observer with two arguments: an array of elements shown in the browser’s viewport and an imageObserver instance.

    Next, loop through entries and perform lazy loading on each of them. For each entry, check if it is intersecting with the viewport, i.e., if it is currently displayed there. If so, set the src attribute to the value of the data-src attribute.

    See this example:

    Copy to clipboard
    const imageObserver = new IntersectionObserver((entries, imgObserver) => {
    entries.forEach((entry) => {
        if(entry.isIntersecting) {
            const lazyImage =
            lazyImage.src = lazyImage.dataset.src
  3. Observe and lazy-load images with ImageObserver.

    Call imageObserver and pass to it all the image elements in the document with document.querySelectorAll('img.lzy_img'). imageObserver listens on the images to detect when they intersect with the browser viewport.

    Copy to clipboard
  4. Verify that lazy loading works.

    Create a few initial images and real images for lazy loading and then create an index.html file that includes the image tags in step 1. Space out the images so that some of them will initially be outside the viewport.

    Here’s an example of a configured image tag:

    Copy to clipboard
    <img class="lzy_img" src="lazy_img.jpg" data-src="img_1.jpg" />

    Within the index.html file, run a script with Intersection Observer and imageObserver, as in the following example.

    Copy to clipboard
        document.addEventListener("DOMContentLoaded", function() {
            const imageObserver = new IntersectionObserver((entries, imgObserver) => {
                entries.forEach((entry) => {
                    if (entry.isIntersecting) {
                        const lazyImage =
                        console.log("lazy loading ", lazyImage)
                        lazyImage.src = lazyImage.dataset.src
            const arr = document.querySelectorAll('img.lzy_img')
            arr.forEach((v) => {

    Place the files on a web server and test them on a web browser.

How Do You Lazy-Load With Cloudinary?

Cloudinary is a cloud-based service that simplifies and automates the process of manipulating, optimizing, and delivering images and videos, optimized for any device at any bandwidth. Those capabilities are offered through the Cloudinary JavaScript SDK, which you can seamlessly integrate with your JS apps.

Hearteningly, lazy loading now works in all modern browsers, meaning that you can lazy-load media by merely adding the loading option to the Cloudinary SDK’s image tag (cl.imageTag), like this:

Copy to clipboard
let img = cl.imageTag('sample.jpg', {width: 300, crop: "scale", loading: "lazy"}).toHtml();

Afterwards, reduce the image size as much as possible to accelerate page loading by adopting one or more of the following Cloudinary features:

  • Smart quality optimization, which automatically compresses images without sacrificing quality. Just add q_auto to your URLs, as explained in this post.
  • Automated file formatting, which serves the correct file format for your browser. Just add f_auto to your URLs. For details, see this post.
  • Progressive image optimization, which renders images with the correct method. You have four options: nonprogressive, steep-progressive, semiprogressive, and default progressive (fl_progressive). Refer to this post for the particulars.

Why not try out all that magic? Start with signing up for a free Cloudinary account. We offer generous free plans to get you started.

Want to Learn More About Lazy-Loading?

Recent Blog Posts

Automation Frees Up PetRescue’s Staff to Help Pets Find Their Forever Homes

As we spend more time at home, many of us are adopting pets for the joy, companionship and a surprising range of health benefits. In Australia, where our nonprofit customer PetRescue is located, there’s a shortage of pets to adopt. Last August, the Guardian reported that dog shelters in Australia emptied and adoption fees for puppies were running as high as $AUS1800.

Read more
Cloudinary and Contentful Make Modern Content Management Easier

I am pleased to share that Cloudinary and Contentful have joined forces to further streamline the creation, processing, and delivery of online content through Cloudinary’s digital asset management (DAM) solution and advanced transformation and delivery capabilities for images and video. What’s more, the partnership delivers a headless approach to DAM. By leveraging APIs for media management tasks, marketers and developers alike benefit from an integrated stack of optimized assets for optimization and automation. As a result, page loads are fast and beautiful, and at scale—with less overhead and effort.

Read more
Introducing Cloudinary's Nuxt Module

Since its initial release in October 2016 by the Chopin brothers as a server-side framework that runs on top of Vue.js, Nuxt (aka Nuxt.js) has gained prominence in both intuitiveness and performance. The framework offers numerous built-in features based on a modular architecture, bringing ease and simplicity to web development. Not surprisingly, Nuxt.js has seen remarkable growth in adoption by the developer community along with accolades galore. At this writing, Nuxt has earned over 30K stars on GitHub and 96 active modules with over a million downloads per month. And the upward trend is ongoing.

Read more
How Quality and Quantity can go Hand in Hand

When it comes to quality versus quantity, you’ll often hear people say, “It’s the quality that counts, not the quantity”. While that’s true in many situations, there are also cases where you want both quality and quantity. You may have thousands of images on your website and you want them all to look great. This is especially important if your website allows users to upload their own content, for example, to sell their own products or services. You don't want their poor quality images to reflect badly on your brand.

Read more
Product Videos 101: What Makes Them Great?

A product’s benefits and usage, including its value proposition, features, and instructive details, are best demonstrated through video. Product-video types vary, depending on the funnel, channel, and audience, the most popular ones being demos, reviews, installation, and how-tos.

Read more