HTMLInputElement : évènement search

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.

L'évènement search de l'interface HTMLInputElement est déclenché lorsqu'une recherche est lancée à l'aide d'un élément HTML <input> de type="search".

Il existe plusieurs façons d'initier une recherche, par exemple en appuyant sur Entrée lorsque l'élément <input> a le focus, ou, si l'attribut incremental est présent, après un délai défini par l'agent utilisateur écoulé depuis la dernière frappe (les nouvelles frappes réinitialisant le délai, de sorte que le déclenchement de l'évènement empêche le rebond).

Les implémentations des agents utilisateurs actuelles de <input type="search"> disposent d'un contrôle supplémentaire pour effacer le champ. L'utilisation de ce contrôle déclenche également l'évènement search. Dans ce cas la propriété value de l'élément <input> sera la chaîne vide.

Cet évènement n'est pas annulable.

Dans cet article

Syntaxe

Utilisez le nom de l'évènement dans des méthodes comme addEventListener(), ou affectez un gestionnaire d'évènements à la propriété correspondante.

js
addEventListener("search", (event) => { })

onsearch = (event) => { }

Type d'évènement

Un objet Event générique.

Exemples

js
// version addEventListener
const input = document.querySelector('input[type="search"]');

input.addEventListener("search", () => {
  console.log(`Terme recherché : ${input.value}`);
});

js
// version onsearch
const input = document.querySelector('input[type="search"]');

input.onsearch = () => {
  console.log(`Terme recherché : ${input.value}`);
};

Spécifications

Cet évènement ne fait partie d'aucune spécification.

Compatibilité des navigateurs

Activez JavaScript pour afficher ce tableau de compatibilité des navigateurs.

Aider à améliorer MDN

Cette page vous a-t-elle été utile ?

Oui Non

Apprendre à contribuer

Cette page a été modifiée le 9 déc. 2025 par les contributeur·ice·s du MDN.

Voir cette page sur GitHub • Signaler un problème avec ce contenu

API HTML DOM
HTMLInputElement
Propriétés d'instance
Méthodes d'instance
Évènements
Héritage
Pages liées à HTML DOM
Guides
1. Utiliser les microtâches en JavaScript avec queueMicrotask()
2. Aller plus loin : Les microtâches et l'environnement d'exécution JavaScript