Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

DOMRectReadOnly.width — anchura de un rectángulo

La propiedad `width`, de solo lectura, devuelve la anchura almacenada del rectángulo como número, conservando su signo y su parte fraccionaria, si la tiene.

Versión: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxis

rect.width

DOMRectReadOnly.width es una propiedad de instancia de solo lectura. Se lee como rect.width, sin paréntesis, y devuelve un valor de tipo number. La unidad depende de la API que proporciona el rectángulo. Por ejemplo, para un elemento HTML, entry.contentRect.width de un ResizeObserverEntry indica la anchura de la caja de contenido en píxeles CSS.

Si creas el rectángulo, el tercer argumento de DOMRectReadOnly define width. Una anchura negativa sigue siendo negativa: con coordenadas finitas y anchura negativa, left vale x + width y right vale x. Para obtener la extensión horizontal no negativa de un rectángulo de anchura finita, usa Math.abs(rect.width).

Asignar un valor a width no modifica una instancia de DOMRectReadOnly: en modo estricto se lanza un TypeError; fuera de ese modo, la asignación se ignora. Si necesitas otra anchura, crea un rectángulo nuevo o usa la propiedad modificable width de un DOMRect. DOMRectReadOnly es una API web, no forma parte de ECMAScript; comprueba si está disponible en tu entorno de ejecución.

Ejemplos

(() => {
  "use strict";

  // Local fallback for runtimes without the Web API. It models only these three properties.
  function demoReadOnlyRect(x, width) {
    return {
      get width() { return width; },
      get left() { return width < 0 ? x + width : x; },
      get right() { return width < 0 ? x : x + width; },
    };
  }

  const rect = typeof DOMRectReadOnly === "function"
    ? new DOMRectReadOnly(10, 0, -4.5, 3)
    : demoReadOnlyRect(10, -4.5);
  console.log(`width=${rect.width}, left=${rect.left}, right=${rect.right}`);

  try {
    rect.width = 8;
  } catch (error) {
    console.log(`TypeError=${error instanceof TypeError}, width=${rect.width}`);
  }
})();

Resultado

width=-4.5, left=5.5, right=10
TypeError=true, width=-4.5

Ejecuta el código en la consola de un navegador compatible con `DOMRectReadOnly` para usar la API nativa. Si `DOMRectReadOnly` no está disponible, como en Node.js, el ejemplo usa un modelo local que solo reproduce `width`, `left` y `right`. La anchura negativa sigue siendo `-4.5` y la asignación en modo estricto lanza un `TypeError` que el ejemplo captura.

Lecciones relacionadas

  • JavaScript · Lección 32 · Intermedio · Versión: 3

Fuentes