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.