Repository navigation
Expand file tree
/
Copy pathindex.md
More file actions
108 lines (81 loc) · 3 KB
/
Copy pathindex.md
File metadata and controls
108 lines (81 loc) · 3 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
---
title: AsyncGenerator.prototype.next()
short-title: next()
slug: Web/JavaScript/Reference/Global_Objects/AsyncGenerator/next
l10n:
sourceCommit: 544b843570cb08d1474cfc5ec03ffb9f4edc0166
---
Die **`next()`**-Methode von {{jsxref("AsyncGenerator")}}-Instanzen gibt den nächsten Wert in der Sequenz zurück.
## Syntax
```js-nolint
next()
next(value)
```
### Parameter
- `value` {{optional_inline}}
- : Ein optionaler Wert, der verwendet wird, um den internen Zustand des Generators zu ändern. Ein an die `next()`-Methode übergebener Wert wird von `yield` empfangen.
### Rückgabewert
Ein {{jsxref("Promise")}}, das beim Auflösen ein {{jsxref("Object")}} mit zwei Eigenschaften zurückgibt:
- `done`
- : Ein boolescher Wert:
- `true`, wenn der Generator das Ende seines Kontrollflusses erreicht hat. In diesem Fall gibt `value` den _Rückgabewert_ des Generators an (der möglicherweise undefiniert ist).
- `false`, wenn der Generator in der Lage ist, weitere Werte zu erzeugen.
- `value`
- : Jeder JavaScript-Wert, der vom Generator "yielded" oder zurückgegeben wurde.
## Beispiele
### Verwenden von next()
Das folgende Beispiel zeigt einen Generator und das Objekt, das die `next`-Methode zurückgibt:
```js
// An async task. Pretend it's doing something more useful
// in practice.
function delayedValue(time, value) {
return new Promise((resolve, reject) => {
setTimeout(() => resolve(value), time);
});
}
async function* createAsyncGenerator() {
yield delayedValue(500, 1);
yield delayedValue(500, 2);
yield delayedValue(500, 3);
}
const asyncGen = createAsyncGenerator();
asyncGen.next().then((res) => console.log(res)); // { value: 1, done: false }
asyncGen.next().then((res) => console.log(res)); // { value: 2, done: false }
asyncGen.next().then((res) => console.log(res)); // { value: 3, done: false }
asyncGen.next().then((res) => console.log(res)); // { value: undefined, done: true }
```
### Werte an den Generator senden
In diesem Beispiel wird `next` mit einem Wert aufgerufen.
> [!NOTE]
> Der erste Aufruf protokolliert nichts, da der Generator zunächst nichts "yielded".
```js
// An async task. Pretend it's doing something more useful
// in practice.
function sleep(time) {
return new Promise((resolve, reject) => {
setTimeout(resolve, time);
});
}
async function* createAsyncGenerator() {
while (true) {
await sleep(500);
const value = yield;
console.log(value);
}
}
async function main() {
const asyncGen = createAsyncGenerator();
// No log at this step: the first value sent through `next` is lost
console.log(await asyncGen.next(1)); // { value: undefined, done: false }
// Logs 2: the value sent through `next`
console.log(await asyncGen.next(2)); // { value: undefined, done: false }
}
main();
```
## Spezifikationen
{{Specifications}}
## Browser-Kompatibilität
{{Compat}}
## Siehe auch
- {{jsxref("Statements/async_function*", "async function*")}}
- [Iteratoren und Generatoren](/de/docs/Web/JavaScript/Guide/Iterators_and_generators) Leitfaden