Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Image — tworzenie elementu obrazu

Image tworzy obiekt HTMLImageElement poza drzewem dokumentu. Opcjonalne argumenty ustawiają wymiary, ale nie wczytują obrazu ani nie zmieniają rozmiaru pliku.

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

Składnia

new Image(); new Image(width); new Image(width, height)

new Image() tworzy element img typu HTMLImageElement, podobnie jak document.createElement("img"). Nie wstawia go do dokumentu. Image to API HTML udostępniane w środowisku Window, a nie część ECMAScript; Node 24 w repozytorium nie dowodzi dostępności tego API. Konstruktor jest obsługiwany przez współczesne silniki przeglądarek.

Opcjonalne argumenty width i height ustawiają odpowiednie atrybuty wymiarów. Nie zmieniają danych obrazu; CSS może wpływać na ostateczny rozmiar wyświetlania. naturalWidth i naturalHeight opisują naturalne wymiary z uwzględnieniem gęstości, w pikselach CSS; przed udostępnieniem obrazu wynoszą 0.

Ustawienie src uruchamia asynchroniczną obsługę zasobu, także poza drzewem dokumentu. Obsłuż zdarzenia load i error albo spełnienie i odrzucenie obietnicy decode() przed wyświetleniem obrazu. Samo complete === true nie dowodzi sukcesu: dotyczy także braku źródła lub błędu. Przy wyświetlaniu ustaw odpowiedni alt.

Przykłady

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);

Wynik

true
32 16
false
0 0

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła