diff options
Diffstat (limited to 'files/pt-br/web/api/location/assign/index.html')
-rw-r--r-- | files/pt-br/web/api/location/assign/index.html | 120 |
1 files changed, 120 insertions, 0 deletions
diff --git a/files/pt-br/web/api/location/assign/index.html b/files/pt-br/web/api/location/assign/index.html new file mode 100644 index 0000000000..e1a1cf8609 --- /dev/null +++ b/files/pt-br/web/api/location/assign/index.html @@ -0,0 +1,120 @@ +--- +title: Location.assign() +slug: Web/API/Location/assign +tags: + - API + - HTML-DOM + - Location + - Referencia + - metodo +translation_of: Web/API/Location/assign +--- +<p>{{ APIRef("HTML DOM") }}</p> + +<p>O método <code><strong>Location.assign()</strong></code> faz com que o navegador carregue o documento na URL especificada e a exiba na janela atual.</p> + +<p>Se a tatefa não poder ser executada por alguma violação de segurança, uma {{domxref("DOMException")}} do tipo <code>SECURITY_ERROR</code> será lançada. Isso acontece se a origem do script chamador do método for diferente da origem da página originalmente descrita no objeto {{domxref("Location")}}, geralmente quando o script está hospedado em um dominio diferente.</p> + +<p>Se a URL especificada for inválida, uma {{domxref("DOMException")}} do tipo <code>SYNTAX_ERROR</code> será lançada.</p> + +<h2 id="Sintaxe">Sintaxe</h2> + +<pre class="syntaxbox"><em>location</em>.assign(<em>url</em>); +</pre> + +<h3 id="Parâmetros">Parâmetros</h3> + +<dl> + <dt><em>url</em></dt> + <dd>É uma {{domxref("DOMString")}} contendo a URL da página destino.</dd> +</dl> + +<h2 id="Exemplos">Exemplos</h2> + +<pre class="brush: js">// Navega para a página do artigo Location.reload +document.location.assign('https://developer.mozilla.org/en-US/docs/Web/API/Location.reload');</pre> + +<h2 id="Especificações">Especificações</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Especificação</th> + <th scope="col">Status</th> + <th scope="col">Comentários</th> + </tr> + <tr> + <td>{{SpecName('HTML WHATWG', "history.html#dom-location-assign", "Location.assign()")}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td>Sem alterações no {{SpecName("HTML5 W3C")}}.</td> + </tr> + <tr> + <td>{{SpecName('HTML5 W3C', "browsers.html#dom-location-assign", "Location.assign()")}}</td> + <td>{{Spec2('HTML5 W3C')}}</td> + <td>Definição inicial.</td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilidade_com_Navegadores">Compatibilidade com Navegadores</h2> + +<p>{{ CompatibilityTable() }}</p> + +<div id="compat-desktop"> +<table class="compat-table"> + <tbody> + <tr> + <th>Característica</th> + <th>Chrome</th> + <th>Edge</th> + <th>Firefox (Gecko)</th> + <th>Internet Explorer</th> + <th>Opera</th> + <th>Safari</th> + </tr> + <tr> + <td>Suporte Básico</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + </tr> + </tbody> +</table> +</div> + +<div id="compat-mobile"> +<table class="compat-table"> + <tbody> + <tr> + <th>Característica</th> + <th>Android</th> + <th>Chrome for Android</th> + <th>Edge</th> + <th>Firefox Mobile (Gecko)</th> + <th>IE Mobile</th> + <th>Opera Mobile</th> + <th>Safari Mobile</th> + </tr> + <tr> + <td>Suporte Básico</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + </tr> + </tbody> +</table> +</div> + +<h2 id="Veja_também">Veja também</h2> + +<ul> + <li>A interface {{domxref("Location")}}.</li> + <li>Métodos Similares: {{domxref("Location.replace()")}} and {{domxref("Location.reload()")}}.</li> +</ul> |