PerformanceElementTiming: naturalWidth-Eigenschaft

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.

Die naturalWidth-Eigenschaft des Lesezugriffs der PerformanceElementTiming-Schnittstelle gibt die intrinsische Breite des Bildelements zurück.

Wert

Ein vorzeichenloser 32-Bit-Integer (unsigned long), der die intrinsische Breite des Bildes darstellt, wenn dies auf ein Bild angewendet wird, oder 0 für Text.

Beispiele

naturalWidth protokollieren

In diesem Beispiel wird ein <img>-Element beobachtet, indem das elementtiming-Attribut hinzugefügt wird. Ein PerformanceObserver wird registriert, um alle Performance-Einträge vom Typ "element" zu erhalten, und das buffered-Flag wird verwendet, um auf Daten von vor der Erstellung des Observers zuzugreifen. Die Bilddatei hat eine Breite von 1000px und eine Höhe von 750px. Der Aufruf von entry.naturalWidth gibt 1000 zurück, was die intrinsische Breite in Pixeln ist.

html
<img
  src="image.jpg"
  alt="a nice image"
  elementtiming="big-image"
  id="myImage" />
js
const observer = new PerformanceObserver((list) => {
  list.getEntries().forEach((entry) => {
    if (entry.identifier === "big-image") {
      console.log(entry.naturalWidth);
    }
  });
});
observer.observe({ type: "element", buffered: true });

Spezifikationen

Specification
Element Timing API
# ref-for-dom-performanceelementtiming-naturalwidth

Browser-Kompatibilität

BCD tables only load in the browser