文档:queryCommandEnabled() 方法

已弃用:此特性不再推荐。虽然某些浏览器可能仍然支持它,但它可能已经从相关的网络标准中删除,可能正在删除过程中,或者可能仅为兼容性目的而保留。请避免使用它,如果可能,请更新现有代码;请参阅本页底部的兼容性表格以指导您的决策。请注意,此特性可能随时停止工作。

非标准:此特性未标准化。我们不建议在生产环境中使用非标准特性,因为它们浏览器支持有限,并且可能会更改或被移除。但是,在没有标准选项的特定情况下,它们可以是合适的替代方案。

注意: 尽管 execCommand() 方法已弃用,但如果您出于该页面上的原因决定使用它,您应该考虑使用 queryCommandEnabled() 检查命令的可用性,以确保兼容性。

Document.queryCommandEnabled() 方法报告指定的编辑器命令是否在浏览器中启用。

语法

js
queryCommandEnabled(command)

参数

command

要确定支持的命令。

返回值

返回一个布尔值,如果命令已启用则为 true,如果命令未启用则为 false

注意

  • 对于 "cut""copy" 命令,该方法仅在从用户发起的线程调用时返回 true。
  • "paste" 命令返回 false,不仅是因为该功能不可用,还因为调用它的脚本没有足够的权限来执行该操作。

示例

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

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

规范

此功能不属于任何当前规范。它不再有望成为标准。有一个非官方的 W3C execCommand 规范草案

浏览器兼容性

另见