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

CKTIS / JavaScript

DOMRect.width — ancho del rectángulo

DOMRect.width es una propiedad de instancia modificable que describe el ancho de un rectángulo. Contiene un número de punto flotante y admite valores negativos. No la confundas con la propiedad de solo lectura DOMRectReadOnly.width.

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

Sintaxis

rect.width
rect.width = value

DOMRect.width describe el ancho del rectángulo representado por un objeto DOMRect. Es una propiedad de instancia: puedes leerla como rect.width y cambiarla con rect.width = value. Su tipo en Web IDL es unrestricted double, representado en JavaScript como number. El valor no tiene que ser entero ni positivo; este tipo también admite NaN, Infinity y -Infinity.

El constructor new DOMRect(x, y, width, height) recibe el ancho como tercer argumento. Un ancho negativo no se convierte automáticamente en un valor positivo. Si x y width son finitos y width es negativo, left es x + width y right es x. Esta regla simplificada no siempre se cumple con valores infinitos: con x = Infinity y width = -Infinity, x + width da NaN, por lo que el cálculo del máximo para right devuelve NaN, no x.

En aritmética exacta, con valores finitos de x y width y un width negativo, right - left sería igual al valor absoluto de width, pero el redondeo en punto flotante de JavaScript puede alterar el resultado. Por ejemplo, con x = 1e20 y width = -8, x + width se redondea a x, por lo que right - left da 0, no 8.

DOMRect hereda de DOMRectReadOnly, pero permite escribir en width. Lo que representa el rectángulo depende de la API que lo haya devuelto; la propiedad por sí sola no especifica qué tipo de área se mide.

Esta es una característica de la API Web descrita en Geometry Interfaces Module Level 1, no una característica de una edición concreta de ECMAScript. MDN la marca como ampliamente disponible en los navegadores desde enero de 2020, también en Web Workers. El ejemplo usa coordenadas explícitas, por lo que no depende del diseño de la página.

Ejemplos

const rect = new DOMRect(10, 20, 30.5, 40);
console.log(rect.width);

rect.width = -8;
console.log(rect.width);
console.log(rect.left, rect.right);

Resultado

30.5
-8
2 10

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes