recursal/MDN huggingface dataset:
URL.search
==========

A propriedade **`search`** da interface `URL` é uma string de pesquisa, também chamada de *query string*, ela é uma `USVString` (en-US) contendo uma `'?'` seguido pelos parâmetros da URL.

Navegadores modernos fornecem a propriedade `URL.searchParams` para facilitar a análise de parâmetros da query string.

**Note:** This feature is available in Web Workers

Valor
-----

Uma `USVString` (en-US).

Exemplos
--------


```js
const url = new URL(
  "https://developer.mozilla.org/pt-BR/docs/Web/API/URL/search?q=123",
);
console.log(url.search); // Logs "?q=123"
```

Especificações
--------------

| Specification |
| --- |
| URL Standard # dom-url-search |

Compatibilidade de browser
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Veja também
-----------

* A interface `URL` a quem pertence.
URL.toString()
==============

O método **`URL.toString()`** stringifier (en-US) retorna a `USVString` (en-US) contendo toda a URL. Efetivamente esta é a versão read-only de `URL.href`.

**Note:** This feature is available in Web Workers

Sintaxe
-------


```js
const href = url.toString();
```

### Retorna o valor

Uma `USVString` (en-US).

Exemplos
--------


```js
const url = new URL(
  "https://developer.mozilla.org/pt-BR/docs/Web/API/URL/toString",
);
url.toString(); // deve rerornar a URL como string
```

Especificações
--------------

| Specification |
| --- |
| URL Standard # URL-stringification-behavior |

Compatibilidade de browser
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Veja também
-----------

* A interface `URL` a quem pertence.
URL.pathname
============

A propriedade **`pathname`** da interface `URL` é uma `USVString` (en-US) qeu contém uma inicial `'/'` seguido pelo caminho da URL não incluindo a query string ou fragmento (ou a string vazia se não houver caminho).

O caminho da URL é uma sequência de segmentos delimitada por `/`, que pode ser um de `.`, `..` ou uma string com zero ou mais caracteres excluindo `/`, `?` e `#` .

Alguns sistemas definem o termo *slug* para significar o segmento final de um caminho não vazio se ele identificar uma página em palavras-chave legíveis. Por exemplo, o URL `https://example.org/articles/this-that-other-outre-collection` tem `this-that-other-outre-collection` como seu slug.

Alguns sistemas usam os caracteres `;` e `=` para delimitar parâmetros e valores de parâmetros aplicáveis a um segmento de caminho. Por exemplo, com a URL `https://example.org/users;id=42/tasks;state=open?sort=modified`, um sistema pode extrair e usar os parâmetros de segmento de caminho `id=42` e `state=open` dos segmentos de caminho `users;id=42` e `tasks;state=open`.

**Note:** This feature is available in Web Workers

Valor
-----

Uma `USVString` (en-US).

Exemplos
--------


```js
const url = new URL(
  "https://developer.mozilla.org/pt-BR/docs/Web/API/URL/pathname?q=value",
);
console.log(url.pathname); // Logs "/pt-BR/docs/Web/API/URL/pathname"
```

Especificações
--------------

| Specification |
| --- |
| URL Standard # dom-url-pathname |

Compatibilidade de browser
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Veja também
-----------

* A interface `URL` a quem pertence.
URL.revokeObjectURL()
=====================

O método estático **`URL.revokeObjectURL()`** anula uma URL que anteriormente foi criada pelo método `URL.createObjectURL()`.

Execute este método quando terminar de utilizar um objeto URL para informar o browser que não preicsa mais manter uma referência deste arquivo.

**Note:** This feature is available in Web Workers


 Este método não esta disponível em service workers, devido a
 questões com cliclo de vida da interface `Blob` e potenciais vazamentos.


Sintaxe
-------


```js
URL.revokeObjectURL(objectURL);
```

### Parâmetros

`objectURL`

Uma `DOMString` representando o objeto URL que anteriormente foi criado com `createObjectURL()`.

Exemplos
--------

Veja Usando o objeto URL para exibir imagens (en-US).

Especificações
--------------

| Specification |
| --- |
| File API # dfn-revokeObjectURL |

Compatibilidade de browser
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Veja também
-----------

* Usando arquivo de uma aplicação web (en-US)
* Usando objetos Url para exibir imagens (en-US)
* `URL.createObjectURL()`
Console.assert()
================

Escreve uma mensagem de erro para o console se a afirmação é falsa. Se a firmação é verdadeira, nada acontece.

**Note:** This feature is available in Web Workers


**Nota:** *O método `console.assert()` é implementado de forma diferente em Node.js.*
 Especificamente, em navegadores, chamando o método console.assert() com uma afirmação falsa fará com que a mensagem a ser impressa para o console não interrompa a execução do código subsequente. Em Node.js, no entanto, uma afirmação falsa causará um *AssertionError.*

Sintaxe
-------
```

console.assert(afirmação, obj1 [, obj2, ..., objN]);
console.assert(afirmação, msg [, subst1, ..., substN]); // c-mensagem de formatação
```

### Parâmetros

`afirmação`

Qualquer expressão booleana. Se a afirmação é falsa, a mensagem é impressa no console.

`obj1` ... `objN`

Uma lista de objetos JavaScript para escrever. As representações de strings de cada um desses objetos são acrescentados juntos na ordem dada e saída.

`msg`

Uma String que contém zero ou mais seguências de substituição.

`subst1` ... `substN`

Objetos JavaScript com qual as strings de substituição `msg` serão substituidas. Isto dá um contriole adicional sobre a mensagem que será escrita.

Ver Outputting text to the console na documentação do `console` para mais detalhes.

Especificações
--------------

| Specification |
| --- |
| Console Standard # assert |

Compatibilidade com navegadores
-------------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Ver também
----------

* WHATWG Console Standard: console.assert
* Opera Dragonfly documentation: Console
* MSDN: Using the F12 Tools Console to View Errors and Status
* Chrome Developer Tools: Using the Console
Console.error()
===============

**Non-standard:** This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.

'*Escreve*' uma mensagem de erro no Web Console.

**Note:** This feature is available in Web Workers

Sintaxe
-------
```

console.error(obj1 [, obj2, ..., objN]);
console.error(msg [, subst1, ..., substN]);
console.exception(obj1 [, obj2, ..., objN]);
console.exception(msg [, subst1, ..., substN]);
```


**Nota:** `console.exception()` é um alias para `console.error()`; as funcionalidades deles são identicas.

### Parâmetros

`obj1` ... `objN`

Uma lista de objetos Javascript para serem escritos. As representações String de cada um destes objetos é ligada junto na ordem listada e escrita.

`msg`

Uma String Javascript contendo zero ou mais Strings de substituição.

`subst1` ... `substN`

Objetos JavaScript o qual substituirão as Strings no `msg`. Este parâmetro fornece controle adicional sobre o formato de output.

Veja Outputting text to the console na documentação de `console` para mais detalhes.

Especificações
--------------

| Specification |
| --- |
| Console Standard # error |

Compatibilidade com navegadores
-------------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Ver também
----------

* Opera Dragonfly documentation: Console
* MSDN: Using the F12 Tools Console to View Errors and Status
* Chrome Developer Tools: Using the Console
Console.count()
===============

Exibe o número de vezes em que a chamada `count()` em particular foi invocada. Essa função recebe um argumento opcional `label`.

**Note:** This feature is available in Web Workers

Se `label` é fornecido, essa função exibe o número de vezes que a função `count()` foi chamada com a respectiva label.

Se `label` for omitido, a função exibe o número de vezes que a função `count()` foi chamada na respectiva linha.

Por exemplo, no código abaixo:


```js
var usuario = "";

function cumprimentar() {
  console.count();
  return "olá " + usuario;
}

usario = "bob";
cumprimentar();
usario = "alice";
cumprimentar();
cumprimentar();
console.count();
```


A saída do console será algo como:
```

"<no label>: 1"
"<no label>: 2"
"<no label>: 3"
"<no label>: 1"
```


Note a última linha da saída do console: a chamada individual de `count()` na linha 11 é tratada como um evento independente.

Se passarmos a variável `usuario` como o argumento `label` para a primeira invocação de `count()`, e a string "alice" para a segunda:


```js
var usuario = "";

function cumprimentar() {
  console.count(usuario);
  return "olá " + usuario;
}

usuario = "bob";
cumprimentar();
usuario = "alice";
cumprimentar();
cumprimentar();
console.count("alice");
```


Teremos uma saída assim:
```

"bob: 1"
"alice: 1"
"alice: 2"
"alice: 3"
```


Agora estamos mantendo contagens separadamente baseadas no valor de `label`. Como a label "alice" na linha 11 corresponde ao valor de `usuario` duas vezes, não é considerado um evento independente.

Sintaxe
-------
```

console.count([label]);
```

Parâmetros
----------

`label`

Uma string. Se for fornecida, exibe o número de vezes que `count()` foi invocada com a mesma label.

Especificações
--------------

| Specification |
| --- |
| Console Standard # count |

Compatibilidade com navegadores
-------------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
Console.timeEnd()
=================

**Non-standard:** This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.

Resumo
------

Interrompe um temporizador que foi anteriormente iniciado por uma chamada a `console.time()`.

Veja Timers (en-US) na documentação de `console` para detalhes e exemplos.

Sintaxe
-------
```

console.timeEnd(label);
```

### Parametros

`label`

O nome do temporizador a ser interrompido. Uma vez interrompido, o tempo decorrido é automaticamente apresentado no Web Console.

Especificação
-------------

Não é parte de qualquer especificação.

Compatibilidade com navegadores
-------------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Veja também
-----------

* `Console.time`
* Opera Dragonfly documentation: Console
Console.log()
=============

**Non-standard:** This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.

Sumário
-------

Exibe uma mensagem na console do navegador.

Syntax
------
```

console.log(obj1[, obj2, ..., objN]);
console.log(msg[, subst1, ..., substN]);
```

Parameters
----------

`obj1` ... `objN`

Uma lista de objetos JavaScript para exibir. A representação por escrito de cada um desses objetos é exibida na ordem com a qual foram inseridos na função.

`msg`

Uma string JavaScript com zero ou mais substituições.

`subst1` ... `substN`

Strings ou objetos JavaScript para substituirem as marcações de substituição em `msg`. Estas substituições ocorrem de um para um e na ordem em que são passadas para a console.log.

Veja Exibindo texto na console (en-US) na documentação do objeto `console` para mais detalhes.

Especificação
-------------

Não faz parte de nenhuma especificação.

Compatibilidade com navegadores
-------------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Ver também
----------

* Opera Dragonfly documentation: Console
* MSDN: Using the F12 Tools Console to View Errors and Status
* Firebug wiki: Console API - Firebug supports additional features in its console.log() implementation, such as styled logging.
* NodeJS: Console API
Console.timeStamp()
===================

**Non-standard:** This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.

Sumário
-------

Adiciona um marcador simples para as ferramentas Timeline ou Waterfall (en-US) do navegador. Ele deixa você relacionar um ponto no seu código com os outros eventos gravados na linha do tempo, como um evento de layout ou de pintura.

Opcionalmente, você pode fornecer um argumento como rótulo do carimbo de hora, e esse rótulo será então mostrado juntamente com a marcação.

**Nota:** essa funcionalidade está disponível em Web Workers.

Sintaxe
-------
```

console.timeStamp(rotulo);
```

Parâmetros
----------

`rotulo`

Rótulo para o carimbo de hora. Opcional.

Especificação
-------------

API do objeto Console

Compatibilidade com navegadores
-------------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Veja também
-----------

* `Console.time()`
* `Console.timeEnd()`
* Adding timestamps to the Waterfall (en-US)
Console.dir()
=============

**Non-standard:** This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.

Resumo
------

Exibe uma lista interativa das propriedades do objeto JavaScript especificado. A saída é apresentada como uma lista hierárquica com triângulos que permitem ver o conteúdo de objetos-filho.

**Note:** This feature is available in Web Workers

![console-dir.png](/pt-BR/docs/Web/API/console/dir_static/console-dir.png)

Sintaxe
-------
```

console.dir(object);
```

Parâmetros
----------

`object`

Um objeto JavaScript cujas propriedades devem ser emitidas.

### Especificação

Console Object API

Compatibilidade com navegadores
-------------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Ver também
----------

* Documentação Opera Dragonfly: Console
* MSDN: usando o F12 Ferramentas de Console para exibir erros e status
console.clear()
===============

O método **`console.clear()`** limpa o console, se o ambiente permitir.

Sintaxe
-------
```

console.clear();
```

Especificações
--------------

| Specification |
| --- |
| Console Standard # clear |

Compatibilidade com navegadores
-------------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
Console.info()
==============

**Non-standard:** This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.

Apresenta uma mensagem de saída no console do navegador . No Firefox e Chrome , um pequeno ícone "i" e apresentado próximo aos items do log do console .

**Note:** This feature is available in Web Workers

Sintaxe
-------
```

console.info(obj1 [, obj2, ..., objN]);
console.info(msg [, subst1, ..., substN]);
```

Parâmetros
----------

`obj1` ... `objN`

`A lista de objetos javascript para saída . As representações de strings de cada um desses objetos são anexados juntos em ordem de listagem e saida .`

`msg`

`Uma string javascript que contém zero ou mais strings para substituição.`

`subst1` ... `substN`

`Objeto javascript o qual substitui strings com msg. Isso permite controle adicional sobre o formato da saída.`

Veja Outputting text to the console na documentação `console` para mais detalhes.

Especificações
--------------

| Specification |
| --- |
| Console Standard # info |

Compatibilidade com navegadores
-------------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Veja também
-----------

* Opera Dragonfly documentation: Console
* MSDN: Using the F12 Tools Console to View Errors and Status
Console.warn()
==============

**Non-standard:** This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.

Escreve uma mensagem de alerta no Console Web.

**Note:** This feature is available in Web Workers

**Nota:** No Firefox, warnings têm um pequeno icone de ponto de exclamação perto deles no log do Console Web.

Sintaxe
-------
```

console.warn(obj1 [, obj2, ..., objN]);
console.warn(msg [, subst1, ..., substN]);
```

Parâmetros
----------

`obj1` ... `objN`

Uma lista de objetos JavaScript para escrever. A representação String de cada um destes objetos é ligada junto na ordem listada e escrita.

`msg`

Uma string JavaScript contendo zero ou mais strings de substituição.

`subst1` ... `substN`

Objetos JavaScript com qual as strings de substituição `msg` serão substituidas. Isto dá um contriole adicional sobre a mensagem que será escrita.

Ver Outputting text to the console na documentação do `console` para mais detalhes.

Especificações
--------------

| Specification |
| --- |
| Console Standard # warn |

Compatibilidade com navegadores
-------------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Ver também
----------

* Opera Dragonfly documentation: Console
* MSDN: Using the F12 Tools Console to View Errors and Status
Console.time()
==============

**Non-standard:** This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.

Sumário
-------

Inicia um cronômetro que você pode usar para monitorar quanto tempo uma operação leva. Você dá para cada cronômetro um nome único, e deve ter no máximo 10.000 deles sendo executados na página. Quando você chama `console.timeEnd()` com o mesmo nome, o navegador mostrará o tempo, em milisegundos, que se passou desde que o cronômetro iniciou.

Veja Timers na documentação `console` para detalhes e exemplos.

**Note:** This feature is available in Web Workers

Sintaxe
-------
```

console.time(label);
```

Parâmetros
----------

`label`

O nome para dar ao novo cronômetro. Ele identificará o cronômetro; use o mesmo quando chamar `console.timeEnd()` para parar o cronômetro e obter o tempo na saída do console.

Especificação
-------------

API do objeto Console

Compatibilidade com navegadores
-------------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Veja também
-----------

* `Console.timeEnd()`
* Opera Dragonfly documentation: Console
DOMImplementation.createDocument()
==================================

O método **`DOMImplementation.createDocument()`** cria e retorna um `XMLDocument`.

Sintaxe
-------
```

doc = document.implementation.createDocument(namespaceURI, qualifiedNameStr, documentType);
```

### Parâmetros

*namespaceURI*

É um `DOMString` contendo a URI do namespace do documento que será criado, ou `null` se o documento não pertencer a nenhum.

*qualifiedNameStr*

Is a `DOMString` containing the qualified name, that is an optional prefix and colon plus the local root element name, of the document to be created.

*documentType* Optional

Is the `DocumentType` (en-US) of the document to be created. It defaults to `null`.

Example
-------


```js
var doc = document.implementation.createDocument(
  "https://www.w3.org/1999/xhtml",
  "html",
  null,
);
var body = document.createElementNS("https://www.w3.org/1999/xhtml", "body");
body.setAttribute("id", "abc");
doc.documentElement.appendChild(body);
alert(doc.getElementById("abc")); // [object HTMLBodyElement]
```

Especificações
--------------

| Specification |
| --- |
| DOM Standard # ref-for-dom-domimplementation-createdocument② |

Compatibilidade com navegadores
-------------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

See also
--------

* The `DOMImplementation` (en-US) interface it belongs to.
SpeechSynthesisUtterance.voice
==============================

**Experimental:** **Esta é uma tecnologia experimental (en-US)**  
Verifique a tabela de compatibilidade entre Navegadores cuidadosamente antes de usar essa funcionalidade em produção.

A propriedade **`voice`** da interface `SpeechSynthesisUtterance` (en-US) retorna e configura a voz que será usada para a fala.

Essa propriedade deve ser configurada para um dos objetos `SpeechSynthesisVoice` (en-US) retornado por `SpeechSynthesis.getVoices()` (en-US). Se não for configurada no momento da fala, a voz usada será a determinada como default na propriedade `lang` (en-US).

Sintaxe
-------
```

var myVoice = speechSynthesisUtteranceInstance.voice;
speechSynthesisUtteranceInstance.voice = speechSynthesisVoiceInstance;
```

### Valor

Um objeto `SpeechSynthesisVoice` (en-US).

Exemplo
-------


```js
var synth = window.speechSynthesis;

var inputForm = document.querySelector('form');
var inputTxt = document.querySelector('input');
var voiceSelect = document.querySelector('select');

var voices = synth.getVoices();

  ...

inputForm.onsubmit = function(event) {
  event.preventDefault();

  var utterThis = new SpeechSynthesisUtterance(inputTxt.value);
  var selectedOption = voiceSelect.selectedOptions[0].getAttribute('data-name');
  for(i = 0; i < voices.length ; i++) {
    if(voices[i].name === selectedOption) {
      utterThis.voice = voices[i];
    }
  }
  synth.speak(utterThis);
  inputTxt.blur();
}
```

Especificações
--------------

| Specification |
| --- |
| Web Speech API # dom-speechsynthesisutterance-voice |

Compatibilidade com navegadores
-------------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Veja também
-----------

* Web Speech API (en-US)
CloseEvent()
============

O construtor \*\*`CloseEvent()`\*\*cria uma nova instância `CloseEvent`.

Sintaxe
-------
```

var event = new CloseEvent(typeArg, closeEventInit);
```

### Valores

`typeArg`

É uma `DOMString` que representa o nome do evento.

`closeEventInit` Optional

É uma coleção `CloseEventInit`, que possui os seguintes campos:

* `"wasClean"`, opcional e inicialmente de valor `false`, do tipo `long`, indica se uma conexão foi encerrada de forma limpa ou não.
* `"code"`, opcional e inicialmente de valor `0`, do tipo `unsigned short`, este é o código de encerramento da conexão enviado pelo servidor.
* `"reason"`, opcional e inicialmente de valor `''`, do tipo `DOMString`, esta é uma razão humanamente compreensível do porque o servidor encerrou a conexão.

**Nota:** A coleção `CloseEventInit` também aceita campos vindos da coleção `EventInit`.

Especificações
--------------

| Specification |
| --- |
| WebSockets Standard # dom-closeevent-closeevent |

Compatibilidade com navegadores
-------------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Veja também
-----------

* `CloseEvent`, a interface de construção de seus objetos.