From 074785cea106179cb3305637055ab0a009ca74f2 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:42:52 -0500 Subject: initial commit --- .../reference/global_objects/generator/index.html | 178 +++++++++++++++++++++ 1 file changed, 178 insertions(+) create mode 100644 files/pt-br/web/javascript/reference/global_objects/generator/index.html (limited to 'files/pt-br/web/javascript/reference/global_objects/generator') diff --git a/files/pt-br/web/javascript/reference/global_objects/generator/index.html b/files/pt-br/web/javascript/reference/global_objects/generator/index.html new file mode 100644 index 0000000000..6bcf4652df --- /dev/null +++ b/files/pt-br/web/javascript/reference/global_objects/generator/index.html @@ -0,0 +1,178 @@ +--- +title: Generator +slug: Web/JavaScript/Reference/Global_Objects/Generator +translation_of: Web/JavaScript/Reference/Global_Objects/Generator +--- +
{{JSRef}}
+ +

O objeto Generator é retornado por {{jsxref("Statements/function*", "generator function", "", 1)}} e conforme iterable protocol e o iterator protocol.

+ +

Síntaxe

+ +
function* gen() {
+  yield 1;
+  yield 2;
+  yield 3;
+}
+
+var g = gen(); // "Generator { }"
+ +

Métodos

+ +
+
{{jsxref("Generator.prototype.next()")}}
+
Retorna o valor fornecido pela expressão {{jsxref("Operators/yield", "yield")}}.
+
{{jsxref("Generator.prototype.return()")}}
+
Retorna o valor fornecido a finaliza o generator.
+
{{jsxref("Generator.prototype.throw()")}}
+
Lança um erro no generator.
+
+ +

Example

+ +

An infinite iterator

+ +
function* idMaker(){
+    var index = 0;
+    while(true)
+        yield index++;
+}
+
+var gen = idMaker(); // "Generator { }"
+
+console.log(gen.next().value); // 0
+console.log(gen.next().value); // 1
+console.log(gen.next().value); // 2
+// ...
+ +

Objeto legacy generator

+ +

Firefox (SpiderMonkey) também implementa a versão anterior do generator em JavaScript 1.7, onde o asterisco (*) na declaração da função não era necessário (somente era necessário usar a palavra reservada yield no corpo da função). Contudo, legacy generators estão obsoletos. Não os use, eles serão removidos ({{bug(1083482)}}).

+ +

Métodos legacy generator

+ +
+
Generator.prototype.next() {{non-standard_inline}}
+
Retorna o valor fornecido pela expressão {{jsxref("Operators/yield", "yield")}}. Isto corresponde ao next() do ES6.
+
Generator.prototype.close() {{non-standard_inline}}
+
Fecha o generator, então quando chamar next() um erro {{jsxref("StopIteration")}}  será lançado. Isto corresponde ao  método return() do ES6.
+
Generator.prototype.send() {{non-standard_inline}}
+
Usado para enviar um valor para o generator. Este valor é retordo pela expressão {{jsxref("Operators/yield", "yield")}}, e retorna o valor fornecido pelo pelo next {{jsxref("Operators/yield", "yield")}}. send(x) corresponde ao next(x) do ES6.
+
Generator.prototype.throw() {{non-standard_inline}}
+
Lança um erro no generator. Isto corresponde ao método throw() do ES6.
+
+ +

Exemplo do Legacy generator

+ +
function* fibonacci() {
+  var a = yield 1;
+  yield a * 2;
+}
+
+var it = fibonacci();
+console.log(it);          // "Generator {  }"
+console.log(it.next());   // 1
+console.log(it.send(10)); // 20
+console.log(it.close());  // undefined
+console.log(it.next());   // throws StopIteration (Como o generator está fechado)
+
+ +

Especificações

+ + + + + + + + + + + + + + + + + + + +
EspecificaçõesStatusComentário
{{SpecName('ES6', '#sec-generator-objects', 'Generator objects')}}{{Spec2('ES6')}}Definição Inicial
{{SpecName('ESDraft', '#sec-generator-objects', 'Generator objects')}}{{Spec2('ESDraft')}} 
+ +

Compatibilidade nos navegadores

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support{{CompatChrome(39.0)}}{{CompatVersionUnknown}}{{CompatNo}}{{CompatNo}}{{CompatNo}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidAndroid WebviewFirefox Mobile (Gecko)IE MobileOpera MobileSafari MobileChrome for Android
Basic support{{CompatNo}}{{CompatChrome(39.0)}}{{CompatVersionUnknown}}{{CompatNo}}{{CompatNo}}{{CompatNo}}{{CompatChrome(39.0)}}
+
+ +

Veja Também

+ +

Legacy generators

+ + + +

ES6 generators

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