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

A New, Simple Tool for Creating Text Overlays for Images

Many Cloudinary users desire a UI for tasks like creating text overlays for images, which they then embed on webpages or download for marketing campaigns. Generating such overlays with the Cloudinary Media Library UI involves a bit of a learning curve, especially if they require multiple fonts or text lines, which even experienced users might find challenging to implement.

Read more
Transitioning JPEG-Based to JPEG XL-Based Images for Web Platforms

When the JPEG codec was being developed in the late 1980s, no standardized, lossy image-compression formats existed. JPEG became ready at exactly the right time in 1992, when the World Wide Web and digital cameras were about to become a thing. The introduction of HTML’s <img> tag in 1995 ensured the recognition of JPEG as the web format—at least for photographs. During the 1990s, digital cameras replaced analog ones and, given the limited memory capacities of that era, JPEG became the standard format for photography, especially for consumer-grade cameras.

Read more

Amplify Your Jamstack With Video

By Alex Patterson
Amplify Your Jamstack With Cloudinary Video

As defined by Amazon Web Services (AWS), Amplify is a set of products and tools with which mobile and front-end web developers can build and deploy AWS-powered, secure, and scalable full-stack apps. Also, you can efficiently configure their back ends, connect them to your app with just a few lines of code, and deploy static web apps in only three steps. Historically, because of their performance issues, managing images and videos is a daunting challenge for developers. Even though you can easily load media to an S3 bucket with AWS Amplify, transforming, compressing, and responsively delivering them is labor intensive and time consuming.

Read more
Cloudinary Helps Move James Hardie’s Experience Online

While COVID has affected most businesses, it has been particularly hard on those that sell products for the physical ‘brick and mortar’ world. One company that literally fits that bill is our Australian customer James Hardie, the largest global manufacturer of fibre cement products used in both domestic and commercial construction. These are materials that its buyers ideally want to see up close, in detail. When customers have questions, they expect personal service.

Read more