From 074785cea106179cb3305637055ab0a009ca74f2 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:42:52 -0500 Subject: initial commit --- files/pt-br/web/api/formdata/append/index.html | 177 ++++++++++++++++++++++ files/pt-br/web/api/formdata/delete/index.html | 138 +++++++++++++++++ files/pt-br/web/api/formdata/entries/index.html | 77 ++++++++++ files/pt-br/web/api/formdata/formdata/index.html | 184 +++++++++++++++++++++++ files/pt-br/web/api/formdata/get/index.html | 142 +++++++++++++++++ files/pt-br/web/api/formdata/getall/index.html | 74 +++++++++ files/pt-br/web/api/formdata/has/index.html | 81 ++++++++++ files/pt-br/web/api/formdata/index.html | 170 +++++++++++++++++++++ files/pt-br/web/api/formdata/set/index.html | 150 ++++++++++++++++++ 9 files changed, 1193 insertions(+) create mode 100644 files/pt-br/web/api/formdata/append/index.html create mode 100644 files/pt-br/web/api/formdata/delete/index.html create mode 100644 files/pt-br/web/api/formdata/entries/index.html create mode 100644 files/pt-br/web/api/formdata/formdata/index.html create mode 100644 files/pt-br/web/api/formdata/get/index.html create mode 100644 files/pt-br/web/api/formdata/getall/index.html create mode 100644 files/pt-br/web/api/formdata/has/index.html create mode 100644 files/pt-br/web/api/formdata/index.html create mode 100644 files/pt-br/web/api/formdata/set/index.html (limited to 'files/pt-br/web/api/formdata') diff --git a/files/pt-br/web/api/formdata/append/index.html b/files/pt-br/web/api/formdata/append/index.html new file mode 100644 index 0000000000..d181310952 --- /dev/null +++ b/files/pt-br/web/api/formdata/append/index.html @@ -0,0 +1,177 @@ +--- +title: FormData.append() +slug: Web/API/FormData/append +translation_of: Web/API/FormData/append +--- +

{{APIRef("XMLHttpRequest")}}

+ +

O método append()  da Interface {{domxref("FormData")}}  adiciona um novo valor dentro de uma chave existente dentro do objeto FormData ou  adiciona a  chave caso ainda não exista.

+ +

A diferença entre  {{domxref("FormData.set")}} e append() é que se uma  chave específica já exista, {{domxref("FormData.set")}} irá substituir o valor existente com um novo valor, já o append() irá adicionar um novo valor no fim do conjunto de valores.

+ +
+

Nota: Este  metodo esta desponivel no Web Workers.

+
+ +

Sintaxe

+ +

Existe duas versoes deste metodo: um de dois e um outro de tres:

+ +
formData.append(name, value);
+formData.append(name, value, filename);
+ +

Parametros

+ +
+
name
+
O nome do campo cujos dados estão contidas em value.
+
value
+
O valor deste campo . Nas duas versões este é a {{domxref("USVString")}}, ou  caso não seja , este é convertido em string. Na versão de tres parametros este pode ser {{domxref("Blob")}}, {{domxref("File")}}, ou  {{domxref("USVString")}}, de novo, caso nenhum deses forem especificados  este valor é convertido em uma string.
+
filename {{optional_inline}}
+
O filename reporta para o servidor (a {{domxref("USVString")}}), quando a {{domxref("Blob")}} ou {{domxref("File")}} é passado como o segundo parametro. O default filename para  {{domxref("Blob")}} o objecto é "blob".
+
+ +
+

Nota: Se espisificares  {{domxref("Blob")}} como a data append  para o objecto FormData , o filename a ser reportado para o servidor  no "Content-Disposition" header usado para mudar de browser em browser.

+
+ +

Retorna

+ +

Void.

+ +

Exemplo

+ +

As seguintes linhas criam um Objecto FormData vazio:

+ +
var formData = new FormData(); // Corrente vazio
+ +

Podes adicionar chaves/valores pares para usar (domxref("FormData.append")}}:

+ +
formData.append('username', 'Chris');
+formData.append('userpic', myFileInput.files[0], 'chris.jpg');
+ +

Especificações

+ + + + + + + + + + + + + + +
EspecificaçõesEstatoComentario
{{SpecName('XMLHttpRequest','#dom-formdata-append','append()')}}{{Spec2('Fetch')}} 
+ +

Compatibilidade do Browser

+ +
{{CompatibilityTable}}
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
CaracteristicasChromeFirefox (Gecko)Internet ExplorerOperaSafari
Suporte Basico7+{{CompatGeckoDesktop("2.0")}}10+12+5+
append com filename{{CompatVersionUnknown}}{{CompatGeckoDesktop("22.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
Disponivel para Desenvolvedores Web{{CompatVersionUnknown}}{{CompatGeckoDesktop("39.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
CaracteristicasAndroidChrome para AndroidFirefox Mobile (Gecko)Firefox OS (Gecko)IE MobileOpera MobileSafari Mobile
Basic support3.0{{CompatUnknown}}{{CompatGeckoMobile("2.0")}}1.0.1{{CompatUnknown}} +

12+

+ 		{{CompatUnknown}}
append com filename{{CompatUnknown}}{{CompatUnknown}}{{CompatGeckoDesktop("22.0")}}1.2{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
Disponivel para Desenvolvedores Web{{CompatUnknown}}{{CompatUnknown}}{{CompatGeckoDesktop("39.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +
+

Nota: XHR em  Android 4.0 envia conteudo vazio  para FormData com blob.

+
+ +

Notas Gecko

+ +

Antis do Gecko 7.0 {{geckoRelease("7.0")}}, se especificares {{domxref("Blob")}} como a conteudo a ser  adicionado ao objecto, o filename reportado no "Content-Disposition" HTTP header era um string vazio; este resulta em  erros sendo reportados por alguns servidores. Começando com Gecko 7.0, o filename "blob" é enviado.

+ +

Veja Tambem

+ + diff --git a/files/pt-br/web/api/formdata/delete/index.html b/files/pt-br/web/api/formdata/delete/index.html new file mode 100644 index 0000000000..042c16f083 --- /dev/null +++ b/files/pt-br/web/api/formdata/delete/index.html @@ -0,0 +1,138 @@ +--- +title: FormData.delete() +slug: Web/API/FormData/delete +translation_of: Web/API/FormData/delete +--- +

{{APIRef("XMLHttpRequest")}}

+ +

O metodo delete() da  interface {{domxref("FormData")}} deleta uma chave/valor pares do Objecto FormData .

+ +
+

Nota: Este metodo esta Disponivel em Web Workers.

+
+ +

Sintaxe

+ +
formData.delete(name);
+ +

Parametros

+ +
+
name
+
O name da chave que desejas apagar.
+
+ +

Retorna

+ +

Void.

+ +

Exemplo

+ +

Esta linha cria um objecto FormData vazio e subistitui com a chave/valor pares de  form:

+ +
var formData = new FormData(myForm);
+ +

Podes deletar chave/valor pares usando delete():

+ +
formData.delete('username');
+
+ +

Specificasões

+ + + + + + + + + + + + + + +
SpecificasõesStatusComment
{{SpecName('XMLHttpRequest','#dom-formdata-delete','delete()')}}{{Spec2('XMLHttpRequest')}} 
+ +

Compatibilidade do Browser 

+ +
{{CompatibilityTable}}
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
CarracteristicasChromeFirefox (Gecko)Internet ExplorerOperaSafari
Suporte Basico{{CompatVersionUnknown}}{{CompatGeckoDesktop("39.0")}}{{CompatNo}}{{CompatVersionUnknown}}{{CompatNo}}
Disponivel em Web Workes{{CompatVersionUnknown}}{{CompatGeckoDesktop("39.0")}}{{CompatNo}}{{CompatVersionUnknown}}{{CompatNo}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
CaracteristicasAndroidChrome for AndroidFirefox Mobile (Gecko)Firefox OS (Gecko)IE MobileOpera MobileSafari Mobile
Suporte Basico{{CompatNo}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatNo}} +

{{CompatVersionUnknown}}

+ 		{{CompatNo}}
Disponivel em web workers{{CompatNo}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatNo}}{{CompatVersionUnknown}}{{CompatNo}}
+
+ +

Veja Tambem

+ + diff --git a/files/pt-br/web/api/formdata/entries/index.html b/files/pt-br/web/api/formdata/entries/index.html new file mode 100644 index 0000000000..911c269074 --- /dev/null +++ b/files/pt-br/web/api/formdata/entries/index.html @@ -0,0 +1,77 @@ +--- +title: FormData.entries() +slug: Web/API/FormData/entries +tags: + - API + - FormData + - Iterador + - Referencia + - XMLHttpRequest API + - metodo +translation_of: Web/API/FormData/entries +--- +

{{APIRef("XMLHttpRequest")}}

+ +

O método FormData.entries() retorna um {{jsxref("Iteration_protocols",'iterator')}} permitindo percorrer todos os valores de chave/valor contidos nesse objeto. A chave de cada par é um objeto {{domxref("USVString")}}; o valor é {{domxref("USVString")}}, ou um {{domxref("Blob")}}.

+ +
+

Note: This method is available in Web Workers.

+
+ +

Sintaxe

+ +
formData.entries();
+ +

Valor retornado

+ +

Retorna um {{jsxref("Iteration_protocols","iterator")}}.

+ +

Exemplo

+ +
// Criação de um objeto teste de FormData
+var formData = new FormData();
+formData.append('key1', 'value1');
+formData.append('key2', 'value2');
+
+// Exibição dos valores chave/valor
+for(var pair of formData.entries()) {
+   console.log(pair[0]+ ', '+ pair[1]);
+}
+
+ +

O resultado é:

+ +
key1, value1
+key2, value2
+ +

Especificações

+ + + + + + + + + + + + + + +
EspecificaçãoStatusComentário
{{SpecName('XMLHttpRequest','#dom-formdata','entries() (as iterator<>)')}}{{Spec2('XMLHttpRequest')}}Initial definition
+ +

Compatibilidade de navegadores

+ + + +

{{Compat("api.FormData.entries")}}

+ +

Veja também

+ + diff --git a/files/pt-br/web/api/formdata/formdata/index.html b/files/pt-br/web/api/formdata/formdata/index.html new file mode 100644 index 0000000000..2202cac454 --- /dev/null +++ b/files/pt-br/web/api/formdata/formdata/index.html @@ -0,0 +1,184 @@ +--- +title: FormData() +slug: Web/API/FormData/FormData +translation_of: Web/API/FormData/FormData +--- +

{{APIRef("XMLHttpRequest")}}

+ +

O FormData() construtor cria um novo objeto {{domxref("FormData")}}.

+ +
+

Nota: Este recurso está disponível em Web Workers.

+
+ +

Sintaxe

+ +
var formData = new FormData(form)
+ +

Parâmetros

+ +
+
form {{optional_inline}}
+
Um elemento HTML {{HTMLElement("form")}} — quando especifico, o objeto {{domxref("FormData")}} será preenchido com as chaves/valores atuais do formulário usando a propriedade name de cada elemento para as chaves e seu valor enviado para os valores. Também condificará conteúdo de entrada do arquivo.
+
+ +

Exemplo

+ +

A linha a seguir cria um objeto FormData vázio:

+ +
var formData = new FormData(); // Currently empty
+ +

Você poderia adicionar uma chave/valor usando {{domxref("FormData.append")}}:

+ +
formData.append('username', 'Chris');
+
+ +

Ou você pode especificicar o opcional form argument ao criar o objeto FormData, para o popular com valores de forma especifica:

+ +
<form id="myForm" name="myForm">
+  <div>
+    <label for="username">Enter name:</label>
+    <input type="text" id="username" name="username">
+  </div>
+  <div>
+    <label for="useracc">Enter account number:</label>
+    <input type="text" id="useracc" name="useracc">
+  </div>
+  <div>
+    <label for="userfile">Upload file:</label>
+    <input type="file" id="userfile" name="userfile">
+  </div>
+<input type="submit" value="Submit!">
+</form>
+
+ +
+

Nota: Todos os elementos de entrada têm um atributo 'name'. Para que possa acessar seus valores mais tarde.

+
+ +
var myForm = document.getElementById('myForm');
+formData = new FormData(myForm);
+ +

Especificações

+ + + + + + + + + + + + + + +
EspecificaçãoStatusComentário
{{SpecName('XMLHttpRequest','#dom-formdata','FormData()')}}{{Spec2('XMLHttpRequest')}}Definição inicial
+ +

Compatibilidade dos navegadores

+ +
{{CompatibilityTable}}
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support7{{CompatGeckoDesktop("2.0")}}10125
append with filename{{CompatVersionUnknown}}{{CompatGeckoDesktop("22.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
available in web workers{{CompatVersionUnknown}}{{CompatGeckoDesktop("39.0")}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support3.0{{CompatUnknown}}{{CompatGeckoMobile("2.0")}}{{CompatUnknown}} +

12

+ 		{{CompatUnknown}}
append with filename{{CompatUnknown}}{{CompatUnknown}}{{CompatGeckoMobile("22.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
Available in web workers{{CompatUnknown}}{{CompatUnknown}}{{CompatGeckoMobile("39.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+ +

 

+ +
+

Note: XHR in Android 4.0 sends empty content for FormData with blob.

+
+ +

Gecko notes

+ +

Prior to Gecko 7.0 {{geckoRelease("7.0")}}, if you specified a {{domxref("Blob")}} as the data to append to the object, the filename reported in the "Content-Disposition" HTTP header was an empty string; this resulted in errors being reported by some servers. Starting in Gecko 7.0, the filename "blob" is sent.

+ +

Veja também

+ + +
diff --git a/files/pt-br/web/api/formdata/get/index.html b/files/pt-br/web/api/formdata/get/index.html new file mode 100644 index 0000000000..6e4c11caad --- /dev/null +++ b/files/pt-br/web/api/formdata/get/index.html @@ -0,0 +1,142 @@ +--- +title: FormData.get() +slug: Web/API/FormData/get +translation_of: Web/API/FormData/get +--- +

{{APIRef("XMLHttpRequest")}}

+ +

O método get() da interface {{domxref("FormData")}} retorna o primeiro valor associado com a chave fornecida de um objeto do tipo FormData.

+ +
+

Nota: Este método está disponível em Web Workers.

+
+ +

Sintaxe

+ +
formData.get(nome);
+ +

Parâmetros

+ +
+
nome
+
Um {{domxref("USVString")}} representando o nome da chave que queira retornar.
+
+ +

Retorno

+ +

Um {{domxref("FormDataEntryValue")}} contendo o valor.

+ +

Exemplo

+ +

A linha abaixo cria um objeto vazio do tipo FormData.

+ +
var formData = new FormData();
+ +

Se adicionarmos dois valores usuario_nome usando {{domxref("FormData.append")}}:

+ +
formData.append('usuario_nome', 'Sabrina');
+formData.append('usuario_nome', 'Antônio');
+ +

A função get() abaixo apenas irá retornar o primeiro valor usuario_nome incluido:

+ +
formData.get('usuario_nome'); // Retorna "Sabrina"
+ +

Especificações

+ + + + + + + + + + + + + + +
EspecificaçãoStatusComentário
{{SpecName('XMLHttpRequest','#dom-formdata-get','get()')}}{{Spec2('XMLHttpRequest')}} 
+ +

Compatibilidade de navegadores

+ +
{{CompatibilityTable}}
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
RecursoChromeFirefox (Gecko)Internet ExplorerOperaSafari
Suporte básico{{CompatNo}}{{CompatGeckoDesktop('39.0')}}{{CompatNo}}{{CompatVersionUnknown}}{{CompatNo}}
Available in web workers{{CompatNo}}{{CompatGeckoDesktop('39.0')}}{{CompatNo}}{{CompatVersionUnknown}}{{CompatNo}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
RecursoAndroidChrome for AndroidFirefox Mobile (Gecko)Firefox OS (Gecko)IE MobileOpera MobileSafari Mobile
Suporte básico{{CompatNo}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatNo}} +

{{CompatVersionUnknown}}

+ 		{{CompatNo}}
Available in web workers{{CompatNo}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatNo}}{{CompatVersionUnknown}}{{CompatNo}}
+
+ +

Veja também

+ + diff --git a/files/pt-br/web/api/formdata/getall/index.html b/files/pt-br/web/api/formdata/getall/index.html new file mode 100644 index 0000000000..5a9b51611c --- /dev/null +++ b/files/pt-br/web/api/formdata/getall/index.html @@ -0,0 +1,74 @@ +--- +title: FormData.getAll() +slug: Web/API/FormData/getAll +translation_of: Web/API/FormData/getAll +--- +

{{APIRef("XMLHttpRequest")}}

+ +

O metodo getAll() do {{domxref("FormData")}} retorna todos os valores associados com a chave dentro de um objeto FormData.

+ +
+

Nota: Este metodo esta disponivel no Web Workers.

+
+ +

Syntax

+ +
formData.getAll(name);
+ +

Parametros

+ +
+
nome
+
O {{domxref("USVString")}} representa o mome da chave que você quer pegar.
+
+ +

Retorno

+ +

Um array de {{domxref("FormDataEntryValue")}}s.

+ +

Examplo

+ +

A seguinte linha cria um objeto FormData vazio:

+ +
var formData = new FormData();
+ +

Se nos adicionarmos dois valores oara username {{domxref("FormData.append")}}:

+ +
formData.append('username', 'Chris');
+formData.append('username', 'Bob');
+ +

A seguinte função getAll() retornara um arrat com os valore dentro de username:

+ +
formData.getAll('username'); // Returns ["Chris", "Bob"]
+ +

Especificação

+ + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('XMLHttpRequest','#dom-formdata-getall','getAll()')}}{{Spec2('XMLHttpRequest')}} 
+ +

Compatibilidade de Browsers

+ + + +

{{Compat("api.FormData.getAll")}}

+ +

Veja também

+ + diff --git a/files/pt-br/web/api/formdata/has/index.html b/files/pt-br/web/api/formdata/has/index.html new file mode 100644 index 0000000000..d9cdeff60b --- /dev/null +++ b/files/pt-br/web/api/formdata/has/index.html @@ -0,0 +1,81 @@ +--- +title: FormData.has() +slug: Web/API/FormData/has +tags: + - API + - FormData + - Referencia + - XHR + - XMLHttlRequest + - has + - metodo +translation_of: Web/API/FormData/has +--- +

{{APIRef("XMLHttpRequest")}}

+ +

O método has() da interface {{domxref("FormData")}} retorna um booleano declarando se o objeto FormData contém uma certa chave.

+ +
+

Note: This method is available in Web Workers.

+
+ +

Sintaxe

+ +
formData.has(name);
+ +

Parâmetros

+ +
+
name
+
Uma {{domxref("USVString")}} que representa o nome da chave que você que testar.
+
+ +

Retorna

+ +

Um {{domxref("Boolean")}}.

+ +

Exemplo

+ +

A linha a seguir cria um objeto FormData vazio:

+ +
var formData = new FormData();
+ +

O trecho a seguir mostra os resultados de testar a existência de username no objeto FormData, antes e depois de acrescentar um valor de username no objeto usando {{domxref("FormData.append")}}:

+ +
formData.has('username'); // Retorna false
+formData.append('username', 'Chris');
+formData.has('username'); // Retorna true
+
+
+ +

Especificações

+ + + + + + + + + + + + + + +
EspecificaçãoStatusComentário
{{SpecName('XMLHttpRequest','#dom-formdata-has','has()')}}{{Spec2('XMLHttpRequest')}}
+ +

Compatibilidade de navegador

+ + + +

{{Compat("api.FormData.has")}}

+ +

Veja também

+ + diff --git a/files/pt-br/web/api/formdata/index.html b/files/pt-br/web/api/formdata/index.html new file mode 100644 index 0000000000..30ba7ccb6a --- /dev/null +++ b/files/pt-br/web/api/formdata/index.html @@ -0,0 +1,170 @@ +--- +title: FormData +slug: Web/API/FormData +translation_of: Web/API/FormData +--- +

{{APIRef("XMLHttpRequest")}}

+ +

A interface FormData fornece uma maneira fácil de construir um conjunto de pares chave/valor representando campos de um elemento form e seus valores, os quais podem ser facilmente enviados utilizado o método send() do XMLHttpRequest. Essa interface utiliza o mesmo formato que um form utilizaria se o tipo de codificação estivesse configurado como "multipart/form-data".

+ +

Um objeto FormData pode ser usado diretamente em uma estrutura {{jsxref("Statements/for...of", "for...of")}} em vez de {{domxref('FormData.entries()', 'entries()')}}: for (var p of myFormData) é o mesmo que for (var p of myFormData.entries()).

+ +
+

Nota: Esse recurso está disponível em https://developer.mozilla.org/pt-BR/docs/Web/API/Web_Workers_API

+
+ +

Construtor

+ +
+
{{domxref("FormData.FormData","FormData()")}}
+
Cria um novo objeto FormData.
+
+ +

Métodos

+ +
+
{{domxref("FormData.append")}}
+
Acrescenta um novo valor em uma chave existente dentro de um objeto FormData, ou adiciona a chave se ela ainda não existir.
+
{{domxref("FormData.delete")}}
+
Apaga um par chave/valor de um objeto FormData.
+
{{domxref("FormData.get")}}
+
Retorna o primeiro valor associado com uma dada chave de dentro de um objeto FormData.
+
{{domxref("FormData.getAll")}}
+
Retorna uma matriz de todos os valores associados a uma determinada chave de dentro de um FormData.
+
{{domxref("FormData.has")}}
+
Retorna um valor boleano indicando se um objeto FormData contém um certo par chave/valor.
+
{{domxref("FormData.set")}}
+
Define um novo valor para uma chave existente dentro de um objeto FormData, ou adiciona a chave/valor se ele ainda não existir.
+
+ +
+

Nota: Para ser claro, a diferença entre {{domxref("FormData.set()")}} e {{domxref("FormData.append()")}} é que, se a chave especificada não existir, {{domxref("FormData.set()")}} irá substituir o valor existente por um novo, enquanto {{domxref("FormData.append()")}} irá acrescentar um novo valor no final dos valores existentes. Veja as suas páginas dedicadas para código de exemplo.

+
+ +

Especificações

+ + + + + + + + + + + + + + +
EspecificaçãoStatusComentário
{{SpecName('XMLHttpRequest','#interface-formdata','FormData')}}{{Spec2('XMLHttpRequest')}}FormData definido na especificação XHR
+ +

Compatibilidade com navegadores

+ +
{{CompatibilityTable}}
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
CaracterísticaChromeFirefox (Gecko)Internet ExplorerOperaSafari
Suporte básico7+{{CompatGeckoDesktop("2.0")}}10+12+5+
append com filename{{CompatVersionUnknown}}{{CompatGeckoDesktop("22.0")}}10+{{CompatUnknown}}{{CompatUnknown}}
delete, get, getAll, has, setBehind Flag{{CompatNo}}{{CompatNo}}{{CompatVersionUnknown}}{{CompatNo}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
CaracterísticaAndroidChrome for AndroidFirefox Mobile (Gecko)Firefox OS (Gecko)IE MobileOpera MobileSafari Mobile
Suporte básico3.0{{CompatUnknown}}{{CompatGeckoMobile("2.0")}}1.0.1{{CompatUnknown}} +

12+

+ 		{{CompatUnknown}}
append com filename{{CompatUnknown}}{{CompatUnknown}}{{CompatGeckoDesktop("22.0")}}1.2{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
delete, get, getAll, has, set{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatNo}}{{CompatNo}}{{CompatNo}}{{CompatVersionUnknown}}{{CompatNo}}
+
+ +
+

Nota: XHR in Android 4.0 envia conteúdo vazio para o FormData com blob.

+ +

Nota: Suporte do Chrome aos métodos que não seja append está atualmente atrás da bandeira "Enable Experimental Web Platform Features".

+
+ +

Notas da Gecko

+ +

Antes do Gecko 7.0 {{geckoRelease("7.0")}}, se você especificasse um {{domxref("Blob")}} como o dado a ser anexado ao objeto, o nome do arquivo relatado no cabeçalho HTTP "Content-Disposition" era uma string vazia; isso resultou em erros sendo relatados por alguns servidores. Começando em Gecko 7.0, o nome do arquivo "blob" é enviado.

+ +

Veja também

+ + diff --git a/files/pt-br/web/api/formdata/set/index.html b/files/pt-br/web/api/formdata/set/index.html new file mode 100644 index 0000000000..a6b7dccb69 --- /dev/null +++ b/files/pt-br/web/api/formdata/set/index.html @@ -0,0 +1,150 @@ +--- +title: FormData.set() +slug: Web/API/FormData/set +translation_of: Web/API/FormData/set +--- +

{{APIRef("XMLHttpRequest")}}

+ +

O método set() da interface {{domxref("FormData")}} adiciona o novo valor para um chave existente em um objeto FormData, ou adicionar a combinação chave/valor caso ela não exista.

+ +

A diferença entre  set() e {{domxref("FormData.append")}} é que, se a chave especificada já existir, set() irá sobrescrever todos os valores existentes pelo novo valor, enquanto o {{domxref("FormData.append")}} apenas acrescenta o novo valor ao conjunto de valores existentes.

+ +
+

Nota: Esse método está disponível em Web Workers.

+
+ +

Sintaxe

+ +

Existem duas versões desse método: uma com dois e outra com três parâmetros:

+ +
formData.set(name, value);
+formData.set(name, value, filename);
+ +

Parâmetros

+ +
+
name
+
O nome do campo cujo dado está em value.
+
value
+
O valor do campo. Na versão de dois parâmetros, esse é um {{domxref("USVString")}}, e caso não seja, ele é convertido para uma string. Na versão de três parâmetros ele pode ser um {domxref("Blob")}}, {{domxref("File")}}, ou um {{domxref("USVString")}}. Se nenhum desses valores forem especificados, o valor será convertido para string.
+
filename {{optional_inline}}
+
O nome do arquivo a ser enviado (um {{domxref("USVString")}}), quando um {{domxref("Blob")}} ou um {{domxref("File")}} é passdo como o segundo parâmetro. O nome de arquivo padrão para objetos do tipo {{domxref("Blob")}} é "blob".
+
+ +
+

Nota: Se você especificar um {{domxref("Blob")}} como o dado a ser acrescentado ao objeto FormData, o nome do arquivo que será enviado para o servidor, enviado no atributo "Content-Disposition" no cabeçalho varia de navegador para navegador.

+
+ +

Exemplo

+ +

A linha a seguir cria um objeto FormData vazio:

+ +
var formData = new FormData(); // Currently empty
+ +

Você pode adicionar os pares chave/valor usando (domxref("FormData.set")}}:

+ +
formData.set('username', 'Chris');
+formData.set('userpic', myFileInput.files[0], 'chris.jpg');
+ +

Especificações

+ + + + + + + + + + + + + + +
EspecificaçãoStatusComentário
{{SpecName('XMLHttpRequest','#dom-formdata-set','set()')}}{{Spec2('XMLHttpRequest')}} 
+ +

Compatibilidade de navegador

+ +
{{CompatibilityTable}}
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
CaracterísticaChromeFirefox (Gecko)Internet ExplorerOperaSafari
Suporte básico{{CompatChrome(50.0)}}{{CompatGeckoDesktop("39.0")}}{{CompatNo}}{{CompatNo}}{{CompatNo}}
DIsponível para web workers{{CompatChrome(50.0)}}{{CompatGeckoDesktop("39.0")}}{{CompatNo}}{{CompatNo}}{{CompatNo}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
CaracterísticaAndroidAndroid WebviewFirefox Mobile (Gecko)Firefox OS (Gecko)IE MobileOpera MobileSafari MobileChrome for Android
Suporte básico{{CompatNo}}{{CompatChrome(50.0)}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatNo}} +

{{CompatNo}}

+ 		{{CompatNo}}{{CompatChrome(50.0)}}
DIsponível para web workers{{CompatNo}}{{CompatChrome(50.0)}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatNo}}{{CompatNo}}{{CompatNo}}{{CompatChrome(50.0)}}
+
+ +

Ver também

+ + -- cgit v1.2.3-54-g00ecf