wp_script_is( string $handle, string $list = 'enqueued' )
Determines whether a script has been added to the queue.
Description
For more information on this and similar theme functions, check out the Conditional Tags article in the Theme Developer Handbook.
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'
Return
(bool) Whether the script is queued.
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 );
}
Changelog
| Version | Description |
|---|---|
| 3.5.0 | 'enqueued' added as an alias of the 'queue' list. |
| 2.8.0 | Introduced. |
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' ); }