jQuery event.isImmediatePropagationStopped() Method

Quiz

The jQuery event.isImmediatePropagationStopped() method is used to check whether event.stopImmediatePropagation() was ever called on this event object.

This method returns a boolean value "true" in case the jQuery event.stopImmediatePropagation() method has been already called, otherwise it returns "false".

Syntax

Following is the syntax of the jQuery event.isImmediatePropagationStopped() method −

event.isImmediatePropagationStopped()

Parameters

This method does not accept any parameter.

Return Value

This method returns "true" if the event.stopImmediatePropagation() method is already called, "false" otherwise.

Example 1

If the event.stopImmediatePropagation() method is already called, this method returns "true".

The following is the basic example of the jQuery event.isImmediatePropagationStopped() method −

<html>
   <head>
      <script src="https://ajax.googleapis.com/ajax/libs/jquery/3.6.0/jquery.min.js"></script>
      <style>
        div{ 
            margin:10px;
            padding:12px; 
            border:2px solid #666; 
            width:160px;
            color: white;
        }
      </style>
    </head>
    <body>
       <p>Click on any box to see the effect:</p>
       <div id = "div1" style = "background-color:blue;">
          OUTER BOX
          <div id = "div2" style = "background-color:red;">
             INNER BOX
             </div> 
        </div>
    <script>
    $(document).ready(function() {
        $("div").click(function(event){	
            alert("This is: " + $(this).text());
            event.stopImmediatePropagation();
            alert("Is immediate propagation stopped? " + event.isImmediatePropagationStopped());
        });	
    });
      </script>
   </body>
</html>

Output

The above program displays two nestedÂ divÂ elements. When aÂ divÂ is clicked, a pop-up indicates whichÂ divÂ was clicked. The pop-up also shows 'true' ifÂ event.stopImmediatePropagation()Â was called, indicating that event propagation has been stopped −

Example 2

IfÂ event.stopImmediatePropagation()Â has not been called on an event handler, theÂ event.isImmediatePropagationStopped()Â method will returnÂ "false" −

<html>
   <head>
      <script src="https://ajax.googleapis.com/ajax/libs/jquery/3.6.0/jquery.min.js"></script>
      <style>
        div{ 
            margin:10px;
            padding:12px; 
            border:2px solid #666; 
            width:160px;
            color: white;
        }
      </style>
    </head>
    <body>
       <p>Click on any box to see the effect:</p>
       <div id = "div1" style = "background-color:blue;">
          OUTER BOX
          <div id = "div2" style = "background-color:red;">
             INNER BOX
             </div> 
        </div>
    <script>
    $(document).ready(function() {
        $("div").click(function(event){	
            alert("This is: " + $(this).text());
            //event.stopImmediatePropagation();
            alert("Is immediate propagation stopped? " + event.isImmediatePropagationStopped());
        });	
    });
      </script>
   </body>
</html>

Output

After executing the above program, displays two nested divs and a button element. When any of div is clicked message appear indicates which div was clicked. If the button is clicked "false" is print −

jquery_ref_events.htm

Print Page