Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Document : méthode queryCommandSupported()

Obsolète

Évitez d'utiliser cette fonctionnalité dans de nouveaux projets. The execCommand() method is "not implemented consistently or fully by user agents, and it is not expected that this will change in the foreseeable future." Cette fonctionnalité peut être candidate à la suppression des standards web ou des navigateurs.

Envisagez d'utiliser plutôt les fonctionnalités suivantes : Async clipboard ou contenteditable.

Non standard: Cette fonctionnalité n'est pas standardisée. Nous déconseillons d'utiliser des fonctionnalités non standard en production, car leur prise en charge par les navigateurs est limitée, et elles peuvent être modifiées ou supprimées. Toutefois, elles peuvent constituer une alternative appropriée dans certains cas où aucune option standard n'existe.

Note : Bien que la méthode execCommand() soit obsolète, si vous décidez de l'utiliser pour les raisons mentionnées sur cette page, vous devriez envisager de vérifier la disponibilité de la commande en utilisant queryCommandSupported() pour garantir la compatibilité.

La méthode queryCommandSupported() de l'interface Document indique si la commande d'éditeur définie est prise en charge par le navigateur.

Syntaxe

js
queryCommandSupported(command)

Paramètres

command

La commande pour laquelle on veut déterminer si elle est prise en charge.

Valeur de retour

Retourne une valeur booléenne qui est true si la commande est prise en charge et false si elle ne l'est pas.

Notes

La commande "paste" (coller) retourne false non seulement si la fonctionnalité n'est pas disponible, mais aussi si le script l'appelant n'a pas les privilèges suffisants pour effectuer l'action.

Exemples

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

if (flg) {
  // ...Faire quelque chose
}

Spécifications

Cette fonctionnalité ne fait partie d'aucune spécification actuelle. Elle n'est plus destinée à devenir un standard. Il existe un brouillon non officiel de la spécification W3C execCommand (angl.).

Compatibilité des navigateurs

Voir aussi