Document.queryCommandEnabled()

The Document.queryCommandEnabled() method reports whether or not the specified editor command is enabled by the browser.

Syntax

<var>isEnabled</var> = document.queryCommandEnabled(<var>command</var>);

Parameters

command

The command for which to determine support.

Return value

Returns a Boolean which is true if the command is enabled and false if the command isn't.

Notes

• For 'cut' and 'copy' commands the method only returns true when called from a user-initiated thread.
• The 'paste' command return false not only if the feature is unavailable, but also if the script calling it has insufficient privileges to perform the action.

Example

var flg = document.queryCommandEnabled("SelectAll");

if(flg) {
  document.execCommand("SelectAll", false, null); // command is enabled, run it
}

Specifications

Browser compatibility

[1] Before Firefox 41, queryCommandEnabled() with arguments cut, copy or paste would throw errors unless the script had special privileges.

See also

• Document.execCommand()
• Document.queryCommandSupported()