From 3f50f57543ab8eb5b45632977bd9af72a5b28161 Mon Sep 17 00:00:00 2001 From: Broccolism <45515332+broccolism@users.noreply.github.com> Date: Wed, 10 Nov 2021 00:48:14 +0900 Subject: [ko] new translation & fix on promise.all and promise.allSettled (#2274) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * :wrench: promise.all description 번역 추가 * :wrench: 구글 크롬 -> Google Chrome * :wrench: promise.allSettled 번역 수정 및 추가 * :wrench: url 수정 * Update files/ko/web/javascript/reference/global_objects/promise/all/index.html * Update files/ko/web/javascript/reference/global_objects/promise/all/index.html * Update files/ko/web/javascript/reference/global_objects/promise/allsettled/index.html * Update files/ko/web/javascript/reference/global_objects/promise/allsettled/index.html * Update files/ko/web/javascript/reference/global_objects/promise/allsettled/index.html * Update files/ko/web/javascript/reference/global_objects/promise/allsettled/index.html Co-authored-by: hochan Lee --- .../global_objects/promise/all/index.html | 6 +- .../global_objects/promise/allsettled/index.html | 72 +++++++++++++++++++--- 2 files changed, 66 insertions(+), 12 deletions(-) (limited to 'files') diff --git a/files/ko/web/javascript/reference/global_objects/promise/all/index.html b/files/ko/web/javascript/reference/global_objects/promise/all/index.html index e26a13dcfc..a38a3fd82e 100644 --- a/files/ko/web/javascript/reference/global_objects/promise/all/index.html +++ b/files/ko/web/javascript/reference/global_objects/promise/all/index.html @@ -30,13 +30,15 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Promise/all

설명

-

Promise.all은 여러 프로미스의 결과를 집계할 때 유용하게 사용할 수 있습니다.

+

이 메서드는 여러 프로미스의 결과를 집계할 때 유용하게 사용할 수 있습니다. 일반적으로 다음 코드를 계속 실행하기 전에 서로 연관된 비동기 작업 여러 개가 모두 이행되어야 하는 경우에 사용됩니다.

+ +

입력 값으로 들어온 프로미스 중 하나라도 거부 당하면 Promise.all()은 즉시 거부합니다. 이에 비해, {{jsxref("Promise.allSettled()")}}가 반환하는 프로미스는 이행/거부 여부에 관계없이 주어진 프로미스가 모두 완료될 때까지 기다립니다. 결과적으로, 주어진 이터러블의 모든 프로미스와 함수의 결과 값을 최종적으로 반환합니다.

이행

diff --git a/files/ko/web/javascript/reference/global_objects/promise/allsettled/index.html b/files/ko/web/javascript/reference/global_objects/promise/allsettled/index.html index 2f8d2798b1..5a9546e58c 100644 --- a/files/ko/web/javascript/reference/global_objects/promise/allsettled/index.html +++ b/files/ko/web/javascript/reference/global_objects/promise/allsettled/index.html @@ -2,31 +2,80 @@ title: Promise.allSettled() slug: Web/JavaScript/Reference/Global_Objects/Promise/allSettled translation_of: Web/JavaScript/Reference/Global_Objects/Promise/allSettled +browser-compat: html.elements.allSettled ---

{{JSRef}}

-

Promise.allSettled() 메소드는 배열이나 별도의 나열 가능한 객체를 통해 나열된 Promise모음이 모두 이행하거나 거부했을 때에 대한 대응을 할 수 있는 Promise 객체를 반환한다.

+

Promise.allSettled() 메서드는 주어진 모든 프로미스를 이행하거나 거부한 후, 각 프로미스에 대한 결과를 나타내는 객체 배열을 반환합니다.

+ +

일반적으로 서로의 성공 여부에 관련 없는 여러 비동기 작업을 수행해야 하거나, 항상 각 프로미스의 실행 결과를 알고 싶을 때 사용합니다.

+ +

그에 비해, {{jsxref("Promise.all()")}}이 반환한 프로미스는 서로 연관된 작업을 수행하거나, 하나라도 거부 당했을 때 즉시 거부하고 싶을 때 적합합니다.

{{EmbedInteractiveExample("pages/js/promise-allsettled.html")}}
-

문법

+

문법

Promise.allSettled(iterable);
-

인자

+

인자

iterable
-
iterable 객체로, 주로 배열({{jsxref("Array")}})을 사용하며, 이들의 요소들은 모두 Promise 객체.
+
멤버가 모두 Promise인, 배열({{jsxref("Array")}})과 같은 이터러블 객체입니다.
-

반환 값

+

반환 값

+ +

지정된 Promise 컬렉션의 모든 Promise가 성공적으로 이행되거나 거부되어 완료되면, 보류 중인 Promise는 비동기적으로 이행됩니다. 그 때, 반환된 Promise의 핸들러는 원래 프로미스 집합에 있는 각 프로미스의 결과를 포함하는 배열을 입력으로 전달합니다.

+ +

단, Promise.allSettled()는 빈 이터러블 객체를 인자로 전달받았을 경우에만 빈 배열로써 이미 이행된 객체를 반환합니다.

+ +

반환된 각 객체별로 status를 확인할 수 있습니다. 만약 fulfilled 상태라면 value를, rejected 상태라면면 reason 속성을 확인할 수 있습니다. value나 reason을 통해 각 Promise가 어떻게 이행(또는 거부)됐는지 알 수 있습니다.

+ +

예제

-

실행할 {{jsxref("Promise")}} 객체로 비동기 방식으로 이행(Resolved) 및 거부(Rejected)된 결과의 모음을 담아 인자로 전달된다. 이 때 반환된 Promise 객체의 핸들러는 각 본래 Promise 객체가 담긴 배열을 전달할 것이다.

+

Promise.allSettled의 사용

-

각 출력 객체는 status 속성을 통해,  fulfilled,상태로 전달되면 value 속성이 전달되고, rejected 상태로 전달 시 reason 속성으로 전달된다. 각 Promise가 어떻게 이행(또는 거부)됐는지 value 속성 및 reason 속성을 통해 알 수 있다.

+

{{jsxref("Promise.then", "Promise.prototype.then()")}}

-

문서 표준

+
+Promise.allSettled([
+  Promise.resolve(33),
+  new Promise(resolve => setTimeout(() => resolve(66), 0)),
+  99,
+  Promise.reject(new Error('an error'))
+])
+.then(values => console.log(values));
+
+// [
+//   {status: "fulfilled", value: 33},
+//   {status: "fulfilled", value: 66},
+//   {status: "fulfilled", value: 99},
+//   {status: "rejected",  reason: Error: an error}
+// ]
+
+ +

{{jsxref("Operators/await", "await")}}

+ +
+const values = await Promise.allSettled([
+  Promise.resolve(33),
+  new Promise(resolve => setTimeout(() => resolve(66), 0)),
+  99,
+  Promise.reject(new Error('an error'))
+])
+console.log(values)
+
+// [
+//   {status: "fulfilled", value: 33},
+//   {status: "fulfilled", value: 66},
+//   {status: "fulfilled", value: 99},
+//   {status: "rejected",  reason: Error: an error}
+// ]
+
+ +

명세

@@ -43,11 +92,14 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Promise/allSettled
-

지원 브라우저

{{Compat("javascript.builtins.Promise.allSettled")}}

+

브라우저 호환성

+ +

{{Compat("javascript.builtins.Promise.allSettled")}}

-

같이 보기

+

같이 보기