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
HTML Editing APIs
The definition of 'execCommand' in that specification.
Editor's Draft Initial definition

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
queryCommandStateChrome 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 YesEdge Mobile Full support YesFirefox Android Full support YesOpera Android Full support YesSafari iOS Full support YesSamsung Internet Android ?

Legend

Full support  
Full support
Compatibility unknown  
Compatibility unknown

See also

Document Tags and Contributors

Last updated by: mfuji09,