CKTIS / JavaScript
Image — ein Bildelement erstellen
Image erstellt außerhalb des Dokumentbaums ein HTMLImageElement. Optionale Argumente legen die Abmessungen fest, laden aber kein Bild und ändern nicht die Größe der Bilddatei.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
new Image(); new Image(width); new Image(width, height)new Image() erstellt ein img-Element vom Typ HTMLImageElement, ähnlich wie document.createElement("img"). Es fügt das Element nicht in das Dokument ein. Image ist eine HTML-API, die in der Window-Umgebung verfügbar ist, und kein Bestandteil von ECMAScript; Node 24 in einem Repository belegt nicht, dass diese API verfügbar ist. Der Konstruktor wird von aktuellen Browser-Engines unterstützt.
Optionale Argumente width und height setzen die entsprechenden Abmessungsattribute. Sie ändern die Bilddaten nicht; CSS kann die endgültige angezeigte Größe beeinflussen. naturalWidth und naturalHeight geben die dichtekorrigierten natürlichen Abmessungen in CSS-Pixeln an; bevor das Bild verfügbar ist, sind sie 0.
Das Setzen von src startet die asynchrone Verarbeitung der Ressource, auch außerhalb des Dokumentbaums. Behandle vor der Anzeige des Bildes die Ereignisse load und error oder die Erfüllung beziehungsweise Ablehnung des decode()-Promises. complete === true allein weist keinen Erfolg nach: Der Wert trifft auch zu, wenn keine Quelle vorhanden ist oder ein Fehler aufgetreten ist. Setze beim Anzeigen des Bildes einen passenden alt-Wert.
Beispiele
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);Ergebnis
true 32 16 false 0 0
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.