CKTIS / JavaScript
Image — créer un élément image
Image crée un objet HTMLImageElement en dehors de l’arbre du document. Les arguments facultatifs définissent ses dimensions, mais ne chargent pas d’image et ne redimensionnent pas le fichier.
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
new Image(); new Image(width); new Image(width, height)new Image() crée un élément img de type HTMLImageElement, tout comme document.createElement("img"). Il ne l’insère pas dans le document. Image est une API HTML exposée dans l’environnement Window, et ne fait pas partie d’ECMAScript ; la présence de Node 24 dans un dépôt ne prouve pas la disponibilité de cette API. Les moteurs de navigateur actuels prennent en charge ce constructeur.
Les arguments facultatifs width et height définissent les attributs de dimension correspondants. Ils ne modifient pas les données de l’image ; CSS peut influer sur sa taille d’affichage finale. naturalWidth et naturalHeight indiquent les dimensions naturelles corrigées de la densité, en pixels CSS ; elles valent 0 tant que l’image n’est pas disponible.
Définir src démarre le traitement asynchrone de la ressource, même en dehors de l’arbre du document. Avant d’afficher l’image, gérez les événements load et error, ou la réalisation et le rejet de la promesse decode(). À lui seul, complete === true ne prouve pas la réussite : cette valeur s’applique aussi en l’absence de source ou en cas d’erreur. Définissez un alt approprié lorsque vous affichez l’image.
Exemples
const image = new Image(32, 16);
console.log(image instanceof HTMLImageElement);
console.log(image.width, image.height);
console.log(image.isConnected);
console.log(image.naturalWidth, image.naturalHeight);Résultat
true 32 16 false 0 0
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.