Document.queryCommandState()

Obsolete
This feature is obsolete. Although it may still work in some browsers, its use is discouraged since it could be removed at any time. Try to avoid using it.

Usage

The queryCommandState method will tell you if the current selection has a certain Document.execCommand() command applied.

Syntax

queryCommandState(String command)

command is a command from Document.execCommand()

Return Value

queryCommandState() can return a Boolean value or null if the state is unknown.

Example

HTML

<div contenteditable="true">Select a part of this text!</div>
<button onclick="makeBold();">Test the state of the 'bold' command</button>

JavaScript

function makeBold() {
 var state = document.queryCommandState("bold");
 switch (state) {
  case true:
   alert("The bold formatting will be removed from the selected text.");
   break;
  case false:
   alert("The selected text will be displayed in bold.");
   break;
  case null:
   alert("The state of the 'bold' command is indeterminable.");
   break;
  }
  document.execCommand('bold');
}

Result

Specifications

Specification Status Comment
execCommand

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
queryCommandState
DeprecatedNon-standard
Chrome Full support 1Edge Full support 12Firefox Full support YesIE Full support YesOpera Full support YesSafari Full support YesWebView Android Full support YesChrome Android Full support YesFirefox Android Full support YesOpera Android Full support YesSafari iOS Full support YesSamsung Internet Android Full support Yes

Legend

Full support  
Full support
Non-standard. Expect poor cross-browser support.
Non-standard. Expect poor cross-browser support.
Deprecated. Not for use in new websites.
Deprecated. Not for use in new websites.

See also