> For the complete documentation index, see [llms.txt](https://partners.tray.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://partners.tray.com.br/themes/construindo-seu-template/referencias/objetos/utils.md).

# utils

O `utils` é um objeto de utilidade técnica que verifica o ambiente da loja virtual, além de adicionar um hash ao final dos assets para que os arquivos não sejam carregados através do cache do navegador.

{% hint style="info" %}
**Disponível em todas as páginas.**
{% endhint %}

### Atributos disponíveis​ <a href="#atributos-disponiveis" id="atributos-disponiveis"></a>

| Atributos                    | Caracteristica                               |
| ---------------------------- | -------------------------------------------- |
| `{{ utils.assets_version }}` | Hash para arquivos estáticos devido a cache. |
| `{{ utils.is_https }}`       | Verifica se está em ambiente seguro.         |
| `{{ utils.is_mobile }}`      | Verifica se o usuário está em um smartphone. |

## Como Usar

Geralmente esse objeto será utilizado em uma condicional `if` ou em algum `href` de tag `link` que for necessário.

### Para aprimorar o carregamento devido ao cache

O objeto `utils` pode ser utilizado como meio de driblar o cache da loja utilizando como no código HTML abaixo.

{% code title="Input" %}

```html
<link href="my.css?{{ utils.assets_version }}" rel="stylesheet"/>
```

{% endcode %}

{% code title="Output" %}

```html
<link href="my.css?123456" rel="stylesheet">
```

{% endcode %}

### Para verificar o ambiente atual

Também é possível verificar se o usuário está em um ambiente seguro "**HTTPS**" utilizando-o como no código HTML abaixo.

{% code title="Input" %}

```html
{% if utils.is_https %}
  <h3>Fique tranquilo, você está navegando em um ambiente seguro!</h3>
{% endif %}
```

{% endcode %}

{% code title="Output" %}

```html
<h3>Fique tranquilo, você está navegando em um ambiente seguro!</h3>
```

{% endcode %}

### Para verificar se o dispositivo atual é Móvel

E verificar se o dispositivo do usuário é um dispositivo móvel "celular, tablet, etc", utilizando-o em condicionais, como o código HTML abaixo, para poder exibir ou ocultar determinados elementos que desejar.

{% code title="Input" %}

```html
{% if utils.is_mobile %}
  </h4>Você está navegando em um smartphone</h4>
{% endif %}
```

{% endcode %}

{% code title="Output" %}

```html
</h4>Você está navegando em um smartphone</h4>
```

{% endcode %}