Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

HTMLAnchorElement : adresse href et destination target

HTMLAnchorElement représente un lien hypertexte dans le DOM du navigateur. Sa propriété href indique l’adresse de la ressource, tandis que target choisit le contexte de navigation dans lequel l’ouvrir. Découvrez la différence entre la propriété href et l’attribut, ainsi que le sens de _blank.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

const anchor = document.createElement("a");
anchor.href = "https://example.com/guide";
anchor.target = "_blank";
anchor.rel = "noopener";

HTMLAnchorElement est l’interface DOM de l’élément de lien hypertexte a et hérite de HTMLElement. Deux propriétés du lien correspondent à des choix distincts : la destination du lien (href) et le contexte dans lequel la ressource doit s’afficher (target). Il s’agit d’une API Web du navigateur, et non d’une partie d’ECMAScript ; la version de Node.js du dépôt ne permet pas d’établir sa disponibilité.

Définir anchor.href met à jour l’attribut href. À la lecture, une adresse relative valide est résolue par rapport à l’URL de base du document, tandis que anchor.getAttribute("href") renvoie le texte stocké dans l’attribut sans cette transformation. Si l’attribut est absent, anchor.href renvoie une chaîne vide. Si l’attribut est présent mais vide, sa valeur est résolue par rapport à l’URL de base du document. Avec une URL de base hiérarchique, le résultat ne conserve pas le fragment éventuel de cette URL. Avec une URL de base opaque, comme une URL data:, la résolution peut échouer ; dans ce cas, anchor.href renvoie également une chaîne vide. Une URL invalide peut être renvoyée sans modification : lire href ne constitue pas une validation de sécurité.

anchor.target reflète l’attribut target. _self désigne le contexte actuel, _blank un nouveau contexte, _parent le contexte parent et _top le contexte le plus élevé. En l’absence de l’ancêtre correspondant, _parent et _top se comportent comme _self. La valeur peut aussi désigner un contexte nommé. _blank ne garantit pas l’ouverture dans un onglet plutôt que dans une fenêtre ; les paramètres du navigateur déterminent ce choix.

Pour _blank, vous pouvez définir explicitement anchor.rel = "noopener" afin d’empêcher l’accès via window.opener ; les navigateurs modernes le font également implicitement pour _blank. Le texte visible du lien devrait annoncer le nouvel onglet ou la nouvelle fenêtre. Attribuer ces propriétés ne déclenche pas à lui seul une navigation. MDN indique que href et target sont largement disponibles depuis juillet 2015 ; cela ne signifie pas que toutes les fonctionnalités de HTMLAnchorElement sont prises en charge de la même manière.

Exemples

const anchor = document.createElement("a");
anchor.href = "https://example.com/guide";
anchor.target = "_blank";
anchor.rel = "noopener";

console.log(anchor.href);
console.log(anchor.getAttribute("href"));
console.log(anchor.target);

Résultat

https://example.com/guide
https://example.com/guide
_blank

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources