wp_script_is( string $handle, string $list = 'enqueued' )

Determines whether a script has been added to the queue.

Contents

Description Description

For more information on this and similar theme functions, check out the Conditional Tags article in the Theme Developer Handbook.

Parameters Parameters

$handle

(string) (Required) Name of the script.

$list

(string) (Optional) Status of the script to check. Accepts 'enqueued', 'registered', 'queue', 'to_do', and 'done'.

Default value: 'enqueued'

Top ↑

Return Return

(bool) Whether the script is queued.

Top ↑

Source Source

File: wp-includes/functions.wp-scripts.php 

function wp_script_is( $handle, $list = 'enqueued' ) {
	_wp_scripts_maybe_doing_it_wrong( __FUNCTION__ );

	return (bool) wp_scripts()->query( $handle, $list );
}

Expand full source code Collapse full source code View on Trac

Top ↑

Changelog Changelog

Changelog
Version Description
3.5.0 'enqueued' added as an alias of the 'queue' list.
2.8.0 Introduced.

Top ↑

Top ↑

Uses Uses

Uses
Uses Description
wp-includes/functions.wp-scripts.php: wp_scripts()

Initialize $wp_scripts if it has not been set.

Top ↑

User Contributed Notes User Contributed Notes

  1. Skip to note 1 content
    You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note
    Contributed by Codex —

    Basic Example
    This would check if the script named ‘fluidVids.js’ is enqueued. If it is enqueued, it does nothing. If it is not enqueued, the files are then registered and enqueued. 

    $handle = 'fluidVids.js';
$list = 'enqueued';
if (wp_script_is( $handle, $list )) {
    return;
} else {
    wp_register_script( 'fluidVids.js', plugin_dir_url(__FILE__).'js/fluidvids.min.js');
    wp_enqueue_script( 'fluidVids.js' );
}

You must log in before being able to contribute a note or feedback.