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

Partner news: Cloudinary-Getty Images Integration

Supported by intelligent automation, Cloudinary serves as an effective conduit between media asset management and delivery so you can take maximum advantage of assets, compress workflows, and build and coordinate engaging and inspiring customer experiences. Through Cloudinary’s Digital Asset Management (DAM) solution, which employs the company’s innovative image and video APIs, creative and marketing teams can benefit from them, as well as from many AI-powered and automated capabilities. As a result, you can transform, optimize, and deliver media at scale on an intuitive UI.

Read more
Why Audio in Video Matters

Many content creators and consumers tend to regard video as visuals, but that’s only part of the experience. Immersive video content includes strong audio. Just like in a movie, the audio for video content comprises many components: the narrator or subjects, the background music that sets the mood and draws viewers in, sound effects, and so forth.

Read more

For Developers: the HTML <picture> Element Explained

By Amarachi Amaechi
For Developers: the HTML <picture> Element Explained

We all know the good ol', tireless <img> element, which has been a long-time go-to for inserting graphics into webpages. Time doesn’t stop, however, and neither do technological advancements. So, let’s get you up to speed with the element’s modern alternative: the <picture> element.

Read more