<!-- review: finished -->

<a id="http-browser"></a>

# Navegador

El módulo crea variables cuyos valores dependen del valor del campo de cabecera de solicitud `User-Agent`.

<a id="variables"></a>

## Variables

<a id="v-modern-browser"></a>

### `$modern_browser`

es igual al valor establecido por la directiva [modern_browser_value](#modern-browser-value), si un navegador fue identificado como moderno;

<a id="v-ancient-browser"></a>

### `$ancient_browser`

es igual al valor establecido por la directiva [ancient_browser_value](#ancient-browser-value), si un navegador fue identificado como antiguo;

<a id="v-msie"></a>

### `$msie`

es igual a "1" si un navegador fue identificado como MSIE de cualquier versión.

<a id="configuration-example-9"></a>

## Ejemplo de configuración

<a id="choosing-an-index-file"></a>

### Elegir un archivo índice:

```nginx
modern_browser_value "modern.";

modern_browser msie      5.5;
modern_browser gecko     1.0.0;
modern_browser opera     9.0;
modern_browser safari    413;
modern_browser konqueror 3.0;

index index.${modern_browser}html index.html;
```

<a id="redirection-for-old-browsers"></a>

### Redirección para navegadores antiguos:

```nginx
modern_browser msie      5.0;
modern_browser gecko     0.9.1;
modern_browser opera     8.0;
modern_browser safari    413;
modern_browser konqueror 3.0;

modern_browser unlisted;

ancient_browser Links Lynx netscape4;

if ($ancient_browser) {
    rewrite ^ /ancient.html;
}
```

<a id="directives-10"></a>

## Directivas

<a id="index-0"></a>

<a id="id2"></a>

### ancient_browser

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `ancient_browser` string ...;   |
|--------------------------------------------------------------------------------------------|---------------------------------|
| Predeterminado                                                                             | —                               |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | http, server, location          |

Si cualquiera de las subcadenas especificadas se encuentra en el campo de cabecera de solicitud `User-Agent`, el navegador será considerado antiguo. La cadena especial "netscape4" corresponde a la expresión regular "^Mozilla/[1-4]".

<a id="index-1"></a>

<a id="ancient-browser-value"></a>

### ancient_browser_value

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `ancient_browser_value` string;   |
|--------------------------------------------------------------------------------------------|-----------------------------------|
| Predeterminado                                                                             | `ancient_browser_value 1;`        |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | http, server, location            |

Establece un valor para la variable [$ancient_browser](#v-ancient-browser).

<a id="index-2"></a>

<a id="id5"></a>

### modern_browser

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `modern_browser` browser version;<br/><br/>`modern_browser` `unlisted`;   |
|--------------------------------------------------------------------------------------------|---------------------------------------------------------------------------|
| Predeterminado                                                                             | —                                                                         |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | http, server, location                                                    |

Especifica una versión a partir de la cual un navegador se considera moderno. Un
navegador puede ser cualquiera de los siguientes: `msie`, `gecko` (navegadores
basados en Mozilla), `opera`, `safari`, o `konqueror`.

Las versiones pueden especificarse en los siguientes formatos: X, X.X, X.X.X, o X.X.X.X. Los valores máximos para cada uno de los formatos son 4000, 4000.99, 4000.99.99, y 4000.99.99.99, respectivamente.

El valor especial `unlisted` especifica considerar un navegador como moderno si no fue listado por las directivas modern_browser y [ancient_browser](#id2). De lo contrario, dicho navegador se considera antiguo. Si una solicitud no proporciona el campo `User-Agent` en la cabecera, el navegador se trata como si no estuviera en la lista.

<a id="index-3"></a>

<a id="modern-browser-value"></a>

### modern_browser_value

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `modern_browser_value` string;   |
|--------------------------------------------------------------------------------------------|----------------------------------|
| Predeterminado                                                                             | `modern_browser_value 1;`        |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | http, server, location           |

Establece un valor para la variable [$modern_browser](#v-modern-browser).