---
title: Screen
slug: Web/API/Screen
translation_of: Web/API/Screen
---
<div>{{APIRef("CSSOM View")}}</div>

<p>La interfaz <code>Screen</code> representa una pantallaa, usualmente la misma donde la ventana actual está siendo visualizada.</p>

<p>Usualmente es también la única en la que la ventana actual está siendo visualizada, obtenida utilizando <code>window.screen</code>.</p>

<h2 id="Example" name="Example">Propiedades</h2>

<dl>
 <dt>{{domxref("Screen.availTop")}}</dt>
 <dd>Especifica la coordenada-y del primer pixel que no está asignado a prestaciones permanentes o semipermanentes de la interfaz de usuario.</dd>
 <dt>{{domxref("Screen.availLeft")}}</dt>
 <dd>Retorna el primer pixel disponible desde el border izquierdo de la pantalla.</dd>
 <dt>{{domxref("Screen.availHeight")}}</dt>
 <dd>Especifica la altura de la pantalla, en pixels, menos la altura de los elementos permanentes o semipermanentes de la interfaz de usuario visualizados por el sistema operativo, como la barra de tareas de Windows.</dd>
 <dt>{{domxref("Screen.availWidth")}}</dt>
 <dd>Retorna el total de espacio horizontal en pixels disponibles para la ventana.</dd>
 <dt>{{domxref("Screen.colorDepth")}}</dt>
 <dd>Retorna la profundidad de color de la pantalla.</dd>
 <dt>{{domxref("Screen.height")}}</dt>
 <dd>Retorna la altura de la pantalla en pixels.</dd>
 <dt>{{domxref("Screen.left")}}</dt>
 <dd>Retorna la distancia en pixels desde el borde izquierdo de la pantalla principal al borde izquierdo de la pantalla actual.</dd>
 <dt>{{domxref("Screen.orientation")}}</dt>
 <dd>Retorna la orientación actual de la pantalla.</dd>
 <dt>{{domxref("Screen.pixelDepth")}}</dt>
 <dd>Obtiene la profundidad de bits de la pantalla.</dd>
 <dt>{{domxref("Screen.top")}}</dt>
 <dd>Retorna la distancia en pixels desde el borde supierior de la pantalla principal al border superior de la pantalla actual.</dd>
 <dt>{{domxref("Screen.width")}}</dt>
 <dd>Retorna la anchura de la pantalla.</dd>
 <dt>{{domxref("Screen.mozEnabled")}} {{gecko_minversion_inline("12.0")}}</dt>
 <dd>Booleano. Estableciendo su valor a false desactivará el dispositivo de pantalla.</dd>
 <dt>{{domxref("Screen.mozBrightness")}} {{gecko_minversion_inline("12.0")}}</dt>
 <dd>Controla el brillo del dispositivo de pantalla. Espera un valor doble-precisión entre 0 y 1.0.</dd>
</dl>

<h3 id="Manejador_de_eventos">Manejador de eventos</h3>

<dl>
 <dt>{{domxref("Screen.onorientationchange")}}</dt>
 <dd>Un manejador para los eventos {{event("orientationchange")}}.</dd>
</dl>

<h2 id="Métodos">Métodos</h2>

<dl>
 <dt>{{domxref("Screen.lockOrientation")}}</dt>
 <dd>Bloquea la orientación de pantalla (sólo funciona en pantalla completa o para apps instaladas)</dd>
 <dt>{{domxref("Screen.unlockOrientation")}}</dt>
 <dd>Desbloquea la orientación de pantalla (sólo funciona en pantalla completa o para apps instaladas)</dd>
</dl>

<p>Métodos heredados de {{domxref("EventTarget")}}</p>

<p>{{page("/en-US/docs/Web/API/EventTarget","Methods")}}</p>

<h2 id="Example" name="Example">Ejemplo</h2>

<pre class="brush:js">if (screen.pixelDepth &lt; 8) {
  // usa versión low-color de la página
} else {
  // usa versión regular, a todo color de la página
}
</pre>

<h2 id="Specification" name="Specification">Especificación</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">Especificación</th>
   <th scope="col">Estado</th>
   <th scope="col">Observaciones</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{ SpecName('CSSOM View', '#the-screen-interface', 'Screen') }}</td>
   <td>{{ Spec2('CSSOM View') }}</td>
   <td></td>
  </tr>
 </tbody>
</table>