Firefox Tomorrow

web api instance method

Document: queryCommandEnabled() method

View on MDN ↗

[!NOTE] Although the execCommand() method is deprecated, if you do decide to use it for reasons given on that page, you should consider checking the command’s availability using queryCommandEnabled() to ensure compatibility.

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

Syntax

queryCommandEnabled(command)

Parameters

  • command
    • : The command for which to determine support.

Return value

Returns a boolean value 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

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

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

Specifications

This feature is not part of any current specification. It is no longer on track to become a standard. There is an unofficial W3C execCommand spec draft.

Browser compatibility

Browser compatibilityCompatibility data is available on the canonical MDN page.

See also