CKTIS / JavaScript
HTMLCanvasElement: contexto de dibujo y dimensiones
HTMLCanvasElement proporciona una superficie de dibujo en el navegador. Aprende a usar getContext(), width y height. Con un contexto 2D, asignar un valor a cualquiera de estas propiedades borra el dibujo y restablece el estado del contexto, aunque el valor no cambie.
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
canvas.getContext(contextType, contextAttributes)
canvas.width = width;
canvas.height = height;HTMLCanvasElement representa un elemento canvas del navegador. El propio elemento contiene la superficie de dibujo; un contexto proporciona las operaciones de dibujo. Es una API web, no forma parte de ECMAScript. Que Node 24 esté presente en un repositorio no demuestra que esta API esté disponible.
Llama a HTMLCanvasElement.getContext en una instancia como canvas.getContext("2d") para obtener un CanvasRenderingContext2D. Un segundo argumento opcional especifica la configuración del contexto. Comprueba el resultado: el método devuelve null si el tipo no es compatible, si el elemento ya tiene otro modo de contexto o si no se puede crear el contexto. Por ejemplo, incluso si el tipo de contexto WebGL es compatible, una llamada con la opción failIfMajorPerformanceCaveat activada puede devolver null, y un nuevo intento en el mismo canvas con esa opción desactivada puede tener éxito. Una vez creado el contexto, las llamadas posteriores en el mismo canvas con el mismo tipo de contexto devuelven ese mismo objeto. Después de transferir el control mediante transferControlToOffscreen(), el método lanza InvalidStateError.
HTMLCanvasElement.width y HTMLCanvasElement.height reflejan los atributos de dimensión y determinan el tamaño de la superficie de dibujo interna. Sus valores predeterminados son 300 y 150, respectivamente. El tamaño de visualización establecido mediante CSS es distinto: escala la imagen y puede hacer que se vea borrosa o distorsionada.
Con un contexto 2D, asignar un valor a width o height borra la superficie, descarta el trazado actual y restablece los valores predeterminados de los ajustes del contexto, como fillStyle, incluso si se asigna el valor actual. Establece las dimensiones antes de configurar el contexto 2D y dibujar; después de cambiar el tamaño, restaura el estado y vuelve a dibujar. Cambiar el tamaño del búfer de dibujo de WebGL no restablece el estado del contexto WebGL. Una vez transferido el control a un OffscreenCanvas mediante transferControlToOffscreen(), asignar un valor a width o height en el elemento original lanza InvalidStateError. La API básica está ampliamente disponible en los navegadores, pero la compatibilidad con tipos de contexto y opciones concretos varía.
Ejemplos
(() => {
const canvas = document.createElement("canvas");
console.log(canvas.width, canvas.height);
canvas.width = 4;
canvas.height = 2;
const ctx = canvas.getContext("2d");
if (ctx === null) {
throw new Error("2D context unavailable");
}
console.log(canvas.getContext("2d") === ctx);
ctx.fillStyle = "#ff0000";
ctx.fillRect(0, 0, canvas.width, canvas.height);
canvas.width = canvas.width;
console.log(canvas.width, canvas.height, ctx.fillStyle);
})();Resultado
300 150 true 4 2 #000000
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.