WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen