From 2dae5b2288db3d00818754ac9eabb79edddb7d96 Mon Sep 17 00:00:00 2001 From: "Queen Vinyl Da.i'gyu-Kazotetsu" Date: Wed, 31 Jul 2024 16:10:31 -0700 Subject: [PATCH] ko: Convert noteblocks to GFM Alerts (part 6) (#22763) This PR converts the noteblocks for the Korean locale to GFM Alerts syntax, using a [conversion script](https://github.com/queengooborg/mdn-toolkit/blob/main/upgrade-noteblock.js). This is part 6. Note: manual adjustments have also been made to correct some issues, including capitalization, syntax, duplicated keywords and more. --- .../ko/web/javascript/memory_management/index.md | 6 ++++-- .../ko/web/javascript/reference/classes/index.md | 9 ++++++--- .../reference/errors/not_defined/index.md | 3 ++- .../reference/functions/arguments/callee/index.md | 3 ++- .../reference/functions/arguments/index.md | 6 ++++-- .../reference/functions/arrow_functions/index.md | 6 ++++-- .../functions/default_parameters/index.md | 3 ++- .../javascript/reference/functions/get/index.md | 3 ++- .../web/javascript/reference/functions/index.md | 3 ++- .../reference/global_objects/array/every/index.md | 3 ++- .../reference/global_objects/array/fill/index.md | 3 ++- .../global_objects/array/filter/index.md | 3 ++- .../global_objects/array/foreach/index.md | 9 ++++++--- .../reference/global_objects/array/from/index.md | 3 ++- .../reference/global_objects/array/index.md | 3 ++- .../global_objects/array/reduce/index.md | 3 ++- .../global_objects/array/values/index.md | 3 ++- .../global_objects/atomics/wait/index.md | 3 ++- .../global_objects/atomics/waitasync/index.md | 3 ++- .../reference/global_objects/bigint/index.md | 3 ++- .../global_objects/bigint/tolocalestring/index.md | 3 ++- .../reference/global_objects/date/date/index.md | 3 ++- .../reference/global_objects/date/index.md | 3 ++- .../date/tolocaledatestring/index.md | 3 ++- .../global_objects/date/tolocalestring/index.md | 3 ++- .../date/tolocaletimestring/index.md | 3 ++- .../reference/global_objects/error/index.md | 6 ++++-- .../global_objects/function/apply/index.md | 6 ++++-- .../global_objects/function/bind/index.md | 3 ++- .../global_objects/function/name/index.md | 3 ++- .../global_objects/generator/next/index.md | 3 ++- .../reference/global_objects/globalthis/index.md | 3 ++- .../intl/datetimeformat/datetimeformat/index.md | 5 +++-- .../intl/datetimeformat/format/index.md | 3 ++- .../intl/locale/getcalendars/index.md | 3 ++- .../intl/locale/gettimezones/index.md | 3 ++- .../intl/locale/getweekinfo/index.md | 3 ++- .../intl/supportedvaluesof/index.md | 3 ++- .../global_objects/json/stringify/index.md | 3 ++- .../reference/global_objects/map/groupby/index.md | 6 ++++-- .../reference/global_objects/map/index.md | 3 ++- .../global_objects/map/symbol.species/index.md | 3 ++- .../reference/global_objects/math/index.md | 3 ++- .../reference/global_objects/math/random/index.md | 3 ++- .../object/__definegetter__/index.md | 3 ++- .../object/__definesetter__/index.md | 3 ++- .../object/__lookupgetter__/index.md | 3 ++- .../object/__lookupsetter__/index.md | 3 ++- .../global_objects/object/defineproperty/index.md | 3 ++- .../reference/global_objects/object/keys/index.md | 3 ++- .../global_objects/object/valueof/index.md | 3 ++- .../global_objects/promise/finally/index.md | 3 ++- .../reference/global_objects/promise/index.md | 9 ++++++--- .../global_objects/promise/then/index.md | 3 ++- .../reference/global_objects/regexp/index.md | 3 ++- .../global_objects/regexp/leftcontext/index.md | 3 ++- .../reference/global_objects/regexp/n/index.md | 3 ++- .../global_objects/regexp/rightcontext/index.md | 3 ++- .../reference/global_objects/set/index.md | 3 ++- .../global_objects/set/issubsetof/index.md | 3 ++- .../global_objects/set/issupersetof/index.md | 3 ++- .../global_objects/string/anchor/index.md | 3 ++- .../reference/global_objects/string/big/index.md | 3 ++- .../global_objects/string/blink/index.md | 3 ++- .../reference/global_objects/string/bold/index.md | 3 ++- .../global_objects/string/fixed/index.md | 3 ++- .../global_objects/string/fontcolor/index.md | 3 ++- .../global_objects/string/fontsize/index.md | 3 ++- .../reference/global_objects/string/index.md | 3 ++- .../global_objects/string/italics/index.md | 3 ++- .../reference/global_objects/string/link/index.md | 3 ++- .../global_objects/string/replace/index.md | 3 ++- .../global_objects/string/small/index.md | 3 ++- .../global_objects/string/split/index.md | 5 +++-- .../global_objects/string/strike/index.md | 3 ++- .../reference/global_objects/string/sub/index.md | 3 ++- .../reference/global_objects/string/sup/index.md | 3 ++- .../reference/global_objects/typedarray/index.md | 3 ++- .../reference/global_objects/undefined/index.md | 3 ++- .../reference/global_objects/weakset/index.md | 3 ++- .../reference/iteration_protocols/index.md | 3 ++- .../reference/operators/instanceof/index.md | 3 ++- .../reference/operators/logical_or/index.md | 3 ++- .../reference/operators/spread_syntax/index.md | 3 ++- .../reference/operators/typeof/index.md | 3 ++- .../reference/statements/async_function/index.md | 3 ++- .../reference/statements/class/index.md | 3 ++- .../reference/statements/for-await...of/index.md | 3 ++- .../javascript/reference/statements/for/index.md | 3 ++- .../reference/statements/label/index.md | 3 ++- .../web/javascript/reference/strict_mode/index.md | 3 ++- .../reference/template_literals/index.md | 3 ++- files/ko/web/manifest/index.md | 3 ++- .../web/media/audio_and_video_delivery/index.md | 15 ++++++++++----- files/ko/web/media/autoplay_guide/index.md | 12 ++++++++---- .../ko/web/media/formats/audio_concepts/index.md | 15 ++++++++++----- .../web/media/formats/codecs_parameter/index.md | 3 ++- .../js13kgames/installable_pwas/index.md | 3 ++- 98 files changed, 244 insertions(+), 123 deletions(-) diff --git a/files/ko/web/javascript/memory_management/index.md b/files/ko/web/javascript/memory_management/index.md index c399fdbfd0ef98..27f10f9d6d1bf2 100644 --- a/files/ko/web/javascript/memory_management/index.md +++ b/files/ko/web/javascript/memory_management/index.md @@ -99,7 +99,8 @@ JavaScript와 같은 고수준 언어들은 "[가비지 콜렉션]( **참고:** 최신 브라우저는 더 이상 참조-세기 가비지 콜렉션 방식을 사용하지 않습니다. +> [!NOTE] +> 최신 브라우저는 더 이상 참조-세기 가비지 콜렉션 방식을 사용하지 않습니다. 참조-세기 알고리즘은 가장 단순하게 구현된 알고리즘입니다. 이 알고리즘은 '어떤 다른 객체도 참조하지 않는 객체'를 '더 이상 필요 없는 객체'라고 여깁니다. 이 객체를 "가비지"라 부르며, 이를 참조하는 다른 객체가 하나도 없는 경우, 수집이 가능합니다. @@ -210,7 +211,8 @@ wm.set(key, { key }); 대략적인 멘탈 모델로, `WeakMap`을 아래와 같은 구현체로 생각해보면: -> **Warning:** 아래는 폴리필도 아니고, 실제 가비지 콜렉션에 관계하는 엔진의 구현체 구조와는 거리가 멉니다. +> [!WARNING] +> 아래는 폴리필도 아니고, 실제 가비지 콜렉션에 관계하는 엔진의 구현체 구조와는 거리가 멉니다. ```js class MyWeakMap { diff --git a/files/ko/web/javascript/reference/classes/index.md b/files/ko/web/javascript/reference/classes/index.md index ef79cb0f086158..d8c5722519ad15 100644 --- a/files/ko/web/javascript/reference/classes/index.md +++ b/files/ko/web/javascript/reference/classes/index.md @@ -62,7 +62,8 @@ console.log(Rectangle.name); // 출력: "Rectangle2" ``` -> **참고:** 클래스 **표현식**에는 [Class 선언](#class_선언) 섹션에 설명된 것과 동일한 호이스팅 제한이 적용됩니다. +> [!NOTE] +> 클래스 **표현식**에는 [Class 선언](#class_선언) 섹션에 설명된 것과 동일한 호이스팅 제한이 적용됩니다. ## Class body 와 메서드 정의 @@ -201,7 +202,8 @@ Rectangle.prototype.prototypeWidth = 25; ### Field 선언 -> **Warning:** public과 private 필드 선언은 JavaScript 표준화 위원회에 [실험적 기능 (stage 3)](https://github.com/tc39/proposal-class-fields) [TC39](https://tc39.es/) 로 제안되어있습니다. 현재 이를 지원하는 브라우져는 제한적인 상태입니다만, [Babel](https://babeljs.io/) 과 같은 build 시스템을 사용한다면 이 기능을 사용해볼 수 있습니다. +> [!WARNING] +> public과 private 필드 선언은 JavaScript 표준화 위원회에 [실험적 기능 (stage 3)](https://github.com/tc39/proposal-class-fields) [TC39](https://tc39.es/) 로 제안되어있습니다. 현재 이를 지원하는 브라우져는 제한적인 상태입니다만, [Babel](https://babeljs.io/) 과 같은 build 시스템을 사용한다면 이 기능을 사용해볼 수 있습니다. #### Public 필드 선언 @@ -241,7 +243,8 @@ class Rectangle { 클래스의 바깥에서 private 필드를 접근하려고 하면 에러가 발생합니다. private필드는 클래스 내부에서만 읽고 쓰기가 가능합니다. 클래스 외부에서 보이지 않도록 정의하였으므로 클래스가 버젼업 되면서 내부 구현이 바뀌더라도 클래스 사용자 입장에서는 이에 아무런 영항을 받지 않도록 할 수 있습니다. -> **Note:** Private 필드는 사용전에 선언되어야 합니다. +> [!NOTE] +> Private 필드는 사용전에 선언되어야 합니다. 일반적인 프로퍼티와는 다르게 private 필드는 값을 할당하면서 만들어질 수 없습니다. diff --git a/files/ko/web/javascript/reference/errors/not_defined/index.md b/files/ko/web/javascript/reference/errors/not_defined/index.md index 29179e3101bafe..7f1dd19a58c7b7 100644 --- a/files/ko/web/javascript/reference/errors/not_defined/index.md +++ b/files/ko/web/javascript/reference/errors/not_defined/index.md @@ -19,7 +19,8 @@ slug: Web/JavaScript/Reference/Errors/Not_defined 존재하지 않는 변수를 참조하는 곳이 있습니다. 이 변수는 선언되어야 합니다. 또는, 현재 스크립트나 {{Glossary("scope")}} 에서 사용이 가능하도록 해야합니다. -> **참고:** 라이브러리(예를 들면 jQuery와 같은)의 로딩은, 반드시 코드에서 "$"와 같은 라이브러리 변수에 접근하기 이전에 수행되어야 합니다. 라이브러리를 로딩하는 {{HTMLElement("script")}} 태그가 그 변수를 사용하는 코드보다 앞에 위치하도록 하세요. +> [!NOTE] +> 라이브러리(예를 들면 jQuery와 같은)의 로딩은, 반드시 코드에서 "$"와 같은 라이브러리 변수에 접근하기 이전에 수행되어야 합니다. 라이브러리를 로딩하는 {{HTMLElement("script")}} 태그가 그 변수를 사용하는 코드보다 앞에 위치하도록 하세요. ## 예 diff --git a/files/ko/web/javascript/reference/functions/arguments/callee/index.md b/files/ko/web/javascript/reference/functions/arguments/callee/index.md index 4e70abb511960b..23b0abb2b5f63e 100644 --- a/files/ko/web/javascript/reference/functions/arguments/callee/index.md +++ b/files/ko/web/javascript/reference/functions/arguments/callee/index.md @@ -11,7 +11,8 @@ slug: Web/JavaScript/Reference/Functions/arguments/callee `callee`는 `arguments` 객체의 속성입니다. 그 함수의 몸통(body) 내에서 현재 실행 중인 함수를 참조하는 데 쓰일 수 있습니다. 이는 함수의 이름을 알 수 없는 경우에 유용합니다, 가령 이름 없는 함수 식(또한 "익명 함수"라 함) 내에서. -> **경고:** ECMAScript 제5판(ES5) 은 [엄격 모드](/ko/docs/JavaScript/Reference/Functions_and_function_scope/Strict_mode)에서 `arguments.callee()`의 사용을 금합니다. function 식(expression)에 이름을 주거나 함수 자체를 호출해야 하는 곳에 function 선언을 사용하여 `arguments.callee()` 사용을 피하세요. +> [!WARNING] +> ECMAScript 제5판(ES5) 은 [엄격 모드](/ko/docs/JavaScript/Reference/Functions_and_function_scope/Strict_mode)에서 `arguments.callee()`의 사용을 금합니다. function 식(expression)에 이름을 주거나 함수 자체를 호출해야 하는 곳에 function 선언을 사용하여 `arguments.callee()` 사용을 피하세요. ### `arguments.callee`는 왜 ES5 엄격 모드에서 제거되었나요? diff --git a/files/ko/web/javascript/reference/functions/arguments/index.md b/files/ko/web/javascript/reference/functions/arguments/index.md index 7b87766c674040..9b816a4187fb3a 100644 --- a/files/ko/web/javascript/reference/functions/arguments/index.md +++ b/files/ko/web/javascript/reference/functions/arguments/index.md @@ -7,9 +7,11 @@ slug: Web/JavaScript/Reference/Functions/arguments **`arguments`** 객체는 함수에 전달된 인수에 해당하는 `Array` 형태의 객체입니다. -> **참고:** ES6 호환 코드를 작성 중이라면 되도록 [나머지 매개변수](/ko/docs/Web/JavaScript/Reference/Functions/rest_parameters) 구문을 사용해야 합니다. +> [!NOTE] +> ES6 호환 코드를 작성 중이라면 되도록 [나머지 매개변수](/ko/docs/Web/JavaScript/Reference/Functions/rest_parameters) 구문을 사용해야 합니다. -> **참고:** "`Array` 형태"란 `arguments`가 {{jsxref("Array.length", "length")}} 속성과 더불어 0부터 인덱스 된 다른 속성을 가지고 있지만, {{jsxref("Array")}}의 {{jsxref("Array.prototype.forEach()", "forEach")}}, {{jsxref("Array.prototype.map()", "map")}}과 같은 내장 메서드를 가지고 있지 않다는 뜻입니다. +> [!NOTE] +> "`Array` 형태"란 `arguments`가 {{jsxref("Array.length", "length")}} 속성과 더불어 0부터 인덱스 된 다른 속성을 가지고 있지만, {{jsxref("Array")}}의 {{jsxref("Array.prototype.forEach()", "forEach")}}, {{jsxref("Array.prototype.map()", "map")}}과 같은 내장 메서드를 가지고 있지 않다는 뜻입니다. {{EmbedInteractiveExample("pages/js/functions-arguments.html")}} diff --git a/files/ko/web/javascript/reference/functions/arrow_functions/index.md b/files/ko/web/javascript/reference/functions/arrow_functions/index.md index 4afb4d7cd9aab5..7204bdc6306b29 100644 --- a/files/ko/web/javascript/reference/functions/arrow_functions/index.md +++ b/files/ko/web/javascript/reference/functions/arrow_functions/index.md @@ -61,7 +61,8 @@ async (param1, param2, ...paramN) => { 기존의 익명 함수를 가장 간단한 화살표 함수로 단계별로 분해해 보겠습니다. 이 과정에서 각 단계는 유효한 화살표 함수입니다. -> **참고:** 기존 함수 표현식과 화살표 함수는 구문 외에도 더 많은 차이점이 있습니다. 다음 몇 개의 하위 섹션에서 두 함수의 동작 차이에 대해 자세히 소개하겠습니다. +> [!NOTE] +> 기존 함수 표현식과 화살표 함수는 구문 외에도 더 많은 차이점이 있습니다. 다음 몇 개의 하위 섹션에서 두 함수의 동작 차이에 대해 자세히 소개하겠습니다. ```js-nolint // 기존의 익명 함수 @@ -238,7 +239,8 @@ class C { } ``` -> **참고:** 클래스 필드는 프로토타입이 아닌 인스턴스에 정의되므로 인스턴스를 생성할 때마다 새 함수 참조가 생성되고 새 클로저가 할당되어 일반적인 언바운드 메서드보다 메모리 사용량이 늘어날 수 있습니다. +> [!NOTE] +> 클래스 필드는 프로토타입이 아닌 인스턴스에 정의되므로 인스턴스를 생성할 때마다 새 함수 참조가 생성되고 새 클로저가 할당되어 일반적인 언바운드 메서드보다 메모리 사용량이 늘어날 수 있습니다. 비슷한 이유로 [`call()`](/ko/docs/Web/JavaScript/Reference/Global_Objects/Function/call), [`apply()`](/ko/docs/Web/JavaScript/Reference/Global_Objects/Function/apply), [`bind()`](/ko/docs/Web/JavaScript/Reference/Global_Objects/Function/bind) 메서드는 화살표 함수에서 호출할 때 유용하지 않습니다. 화살표 함수는 화살표 함수가 정의된 범위를 기반으로 `this`을 설정하고 함수가 호출되는 방식에 따라 `this` 값이 변하지 않기 때문입니다. diff --git a/files/ko/web/javascript/reference/functions/default_parameters/index.md b/files/ko/web/javascript/reference/functions/default_parameters/index.md index 63932c50fb0cee..eccf4bb6449cd7 100644 --- a/files/ko/web/javascript/reference/functions/default_parameters/index.md +++ b/files/ko/web/javascript/reference/functions/default_parameters/index.md @@ -69,7 +69,8 @@ f(); // [1, undefined] f(2); // [2, undefined] ``` -> **참고:** 첫 번째 기본 매개변수와 그 이후의 모든 매개변수는 함수의 [`length`](/ko/docs/Web/JavaScript/Reference/Global_Objects/Function/length)에 영향을 미치지 않습니다. +> [!NOTE] +> 첫 번째 기본 매개변수와 그 이후의 모든 매개변수는 함수의 [`length`](/ko/docs/Web/JavaScript/Reference/Global_Objects/Function/length)에 영향을 미치지 않습니다. 기본 매개변수 생성자는 함수 본문에서 생성된 범위의 상위인 자체 범위에서 동작합니다. diff --git a/files/ko/web/javascript/reference/functions/get/index.md b/files/ko/web/javascript/reference/functions/get/index.md index 9a6762ba3dd176..a5d3edee2e0823 100644 --- a/files/ko/web/javascript/reference/functions/get/index.md +++ b/files/ko/web/javascript/reference/functions/get/index.md @@ -151,7 +151,8 @@ console.log(MyConstants.foo); // 'foo', 정적 접근자의 값 변경 불가 - 값이 지금 당장 필요하지 않은 경우. 나중에 사용할 수도 있고, 경우에 따라 아예 사용되지 않을 수 있습니다. - 값을 사용하면 여러 번 접근하게 되므로 변경되지 않거나 다시 계산할 필요가 없는 값은 다시 계산할 필요가 없습니다. -> **참고:** 즉, 값이 변경될 것으로 예상되는 속성에 대해 게으른 접근자를 작성하면 값을 다시 계산하지 않으므로 게으른 접근자를 작성해서는 안 됩니다. +> [!NOTE] +> 즉, 값이 변경될 것으로 예상되는 속성에 대해 게으른 접근자를 작성하면 값을 다시 계산하지 않으므로 게으른 접근자를 작성해서는 안 됩니다. > > 모든 접근자가 처음부터 '느긋'하며 '메모화'되는 것은 아닙니다. 이런 동작이 필요하면 직접 구현해야 합니다. diff --git a/files/ko/web/javascript/reference/functions/index.md b/files/ko/web/javascript/reference/functions/index.md index 4e09b836a72647..28475dce017d66 100644 --- a/files/ko/web/javascript/reference/functions/index.md +++ b/files/ko/web/javascript/reference/functions/index.md @@ -17,7 +17,8 @@ JavaScript에서 함수는 다른 함수로 전달되거나 반환받을 수 있 함수 값은 일반적으로 [`함수`](/ko/docs/Web/JavaScript/Rference/Global_Objects/Function)의 인스턴스입니다. `함수` 객체의 속성 및 메서드에 대한 자세한 내용은 {{jsxref("Function")}}을 참조하세요. 호출 가능한 값으로 인해 [`typeof`](/ko/docs/Web/JavaScript/Rference/Operators/typeof)가 `"객체"` 대신 `"함수"`를 반환하게 됩니다. -> **참고:** 모든 호출 가능한 값이 `instanceof Function`인 것은 아닙니다. 예를 들어, `Function.prototype` 객체는 호출 가능하지만 `Function`의 인스턴스는 아닙니다. 함수의 [프로토타입 체인](/ko/docs/Web/JavaScript/Inheritance_and_the_prototype_chain)을 수동으로 설정하여 함수가 더 이상 `Function.prototype`에서 상속되지 않도록 할 수도 있습니다. 그러나 이러한 경우는 극히 드뭅니다. +> [!NOTE] +> 모든 호출 가능한 값이 `instanceof Function`인 것은 아닙니다. 예를 들어, `Function.prototype` 객체는 호출 가능하지만 `Function`의 인스턴스는 아닙니다. 함수의 [프로토타입 체인](/ko/docs/Web/JavaScript/Inheritance_and_the_prototype_chain)을 수동으로 설정하여 함수가 더 이상 `Function.prototype`에서 상속되지 않도록 할 수도 있습니다. 그러나 이러한 경우는 극히 드뭅니다. ### 반환 값 diff --git a/files/ko/web/javascript/reference/global_objects/array/every/index.md b/files/ko/web/javascript/reference/global_objects/array/every/index.md index 7a6821bd8e212a..22c6c307107e94 100644 --- a/files/ko/web/javascript/reference/global_objects/array/every/index.md +++ b/files/ko/web/javascript/reference/global_objects/array/every/index.md @@ -49,7 +49,8 @@ every(callbackFn, thisArg) - 이미 방문한 인덱스를 변경해도 `callbackFn`이 다시 호출되지 않습니다. - 배열의 아직 방문하지 않은 기존 요소가 `callbackFn`에 의해 변경되는 경우, `callbackFn`에 전달된 값은 해당 요소가 방문될 당시의 값이 됩니다. [삭제된](/ko/docs/Web/JavaScript/Reference/Operators/delete) 요소는 방문되지 않습니다. -> **경고:** 위에서 설명한 종류의 동시 수정은 이해하기 어려운 코드를 만드는 경우가 많으므로 일반적으로 지양해야 합니다(특별한 경우 제외). +> [!WARNING] +> 위에서 설명한 종류의 동시 수정은 이해하기 어려운 코드를 만드는 경우가 많으므로 일반적으로 지양해야 합니다(특별한 경우 제외). `every()` 메서드는 [범용](/ko/docs/Web/JavaScript/Reference/Global_Objects/Array#범용_배열_메서드)입니다. `this` 값에는 `length` 속성과 정수 키 속성만 있을 것으로 예상합니다. diff --git a/files/ko/web/javascript/reference/global_objects/array/fill/index.md b/files/ko/web/javascript/reference/global_objects/array/fill/index.md index 9edb81c2549df3..5f9e915b0d6577 100644 --- a/files/ko/web/javascript/reference/global_objects/array/fill/index.md +++ b/files/ko/web/javascript/reference/global_objects/array/fill/index.md @@ -47,7 +47,8 @@ fill(value, start, end) `fill()` 메서드는 [범용](/ko/docs/Web/JavaScript/Reference/Global_Objects/Array#범용_배열_메서드)입니다. `this` 값에는 `length` 속성만 있을 것으로 예상합니다. 문자열도 유사 배열이지만, 문자열은 불변이므로 이 메서드를 적용하기에는 적합하지 않습니다. -> **참고:** 빈 배열(`length = 0`)에 `Array.prototype.fill()`을 사용하면 배열에 수정할 내용이 없으므로 배열이 수정되지 않습니다. +> [!NOTE] +> 빈 배열(`length = 0`)에 `Array.prototype.fill()`을 사용하면 배열에 수정할 내용이 없으므로 배열이 수정되지 않습니다. > 배열을 선언할 때 `Array.prototype.fill()`을 사용하려면 배열의 길이가 0이 아닌지 확인하세요. > [예제](#fill을_사용하여_빈_배열_채우기)를 참조하십시오. diff --git a/files/ko/web/javascript/reference/global_objects/array/filter/index.md b/files/ko/web/javascript/reference/global_objects/array/filter/index.md index 1559e8c1778812..4d64ffbc473e41 100644 --- a/files/ko/web/javascript/reference/global_objects/array/filter/index.md +++ b/files/ko/web/javascript/reference/global_objects/array/filter/index.md @@ -47,7 +47,8 @@ filter(callbackFn, thisArg) - 이미 방문한 인덱스를 변경해도 `callbackFn`이 해당 인덱스에 대해 다시 호출되지 않습니다. - 배열의 아직 방문하지 않은 기존 요소가 `callbackFn`에 의해 변경되는 경우, `callbackFn`에 전달된 값은 해당 요소가 방문될 당시의 값이 됩니다. [삭제된](/ko/docs/Web/JavaScript/Reference/Operators/delete) 요소는 방문되지 않습니다. -> **경고:** 위에서 설명한 종류의 동시 수정은 이해하기 어려운 코드를 만드는 경우가 많으므로 일반적으로 지양해야 합니다(특별한 경우 제외). +> [!WARNING] +> 위에서 설명한 종류의 동시 수정은 이해하기 어려운 코드를 만드는 경우가 많으므로 일반적으로 지양해야 합니다(특별한 경우 제외). `filter()` 메서드는 [범용](/ko/docs/Web/JavaScript/Reference/Global_Objects/Array#범용_배열_메서드)입니다. `this` 값에는 `length` 속성과 정수 키 속성만 있을 것으로 예상합니다. diff --git a/files/ko/web/javascript/reference/global_objects/array/foreach/index.md b/files/ko/web/javascript/reference/global_objects/array/foreach/index.md index 834e01fd43b413..f844fb7b9212a8 100644 --- a/files/ko/web/javascript/reference/global_objects/array/foreach/index.md +++ b/files/ko/web/javascript/reference/global_objects/array/foreach/index.md @@ -47,7 +47,8 @@ forEach(callbackFn, thisArg) - 이미 방문한 인덱스를 변경해도 `callbackFn`이 해당 인덱스에 대해 다시 호출되지 않습니다. - 배열의 아직 방문하지 않은 기존 요소가 `callbackFn`에 의해 변경되는 경우, `callbackFn`에 전달된 값은 해당 요소가 방문될 당시의 값이 됩니다. [삭제된](/ko/docs/Web/JavaScript/Reference/Operators/delete) 요소는 방문되지 않습니다. -> **경고:** 위에서 설명한 종류의 동시 수정은 이해하기 어려운 코드를 만드는 경우가 많으므로 일반적으로 지양해야 합니다(특별한 경우 제외). +> [!WARNING] +> 위에서 설명한 종류의 동시 수정은 이해하기 어려운 코드를 만드는 경우가 많으므로 일반적으로 지양해야 합니다(특별한 경우 제외). `forEach()` 메서드는 [범용](/ko/docs/Web/JavaScript/Reference/Global_Objects/Array#범용_배열_메서드)입니다. `this` 값에는 `length` 속성과 정수 키 속성만 있을 것으로 예상합니다. @@ -116,7 +117,8 @@ items.forEach((item) => { ### 배열 콘텐츠 출력 -> **참고:** 배열의 내용을 콘솔에 표시하려면, +> [!NOTE] +> 배열의 내용을 콘솔에 표시하려면, > 배열의 포멧된 버전을 출력하는 {{domxref("console/table", "console.table()")}}을 사용할 수 있습니다. > > 다음 예제는 `forEach()`를 사용하는 또다른 접근 방식을 보여줍니다. @@ -164,7 +166,8 @@ console.log(obj.sum); // 16 `thisArg` 매개변수(`this`)는 `forEach()`에 제공되므로 호출될 때마다 콜백에 전달됩니다. 콜백은 이를 `this` 값으로 사용합니다. -> **참고:** 콜백 함수를 전달할 때 +> [!NOTE] +> 콜백 함수를 전달할 때 > [화살표 함수 표현식](/ko/docs/Web/JavaScript/Reference/Functions/Arrow_functions)을 사용하는 경우, > 모든 화살표 함수가 이 값을 문법적으로(lexical) 바인딩하므로 > {{jsxref("Operators/this", "this")}} 매개 변수를 생략할 수 있습니다. diff --git a/files/ko/web/javascript/reference/global_objects/array/from/index.md b/files/ko/web/javascript/reference/global_objects/array/from/index.md index 67b99cfd9ef80c..906a936369ac90 100644 --- a/files/ko/web/javascript/reference/global_objects/array/from/index.md +++ b/files/ko/web/javascript/reference/global_objects/array/from/index.md @@ -49,7 +49,8 @@ Array.from(arrayLike, mapFn, thisArg) `Array.from()`에는 생성되는 배열의 각 요소에 대해 함수를 실행할 수 있는 {{jsxref("Array/map", "map()")}}과 비슷한 선택적 매개변수 `mapFn`이 있습니다. 좀 더 명확하게 설명하자면, `Array.from(obj, mapFn, thisArg)`는 중간 배열을 생성하지 않는다는 점과 배열이 아직 생성 중이기 때문에 전체 배열 없이 두 개의 인수(`element`, `index`)만 받는다는 점을 제외하면 `Array.from(obj).map(mapFn, thisArg)`과 동일한 결과를 가져옵니다. -> **참고:** 이 동작은 [형식화 배열](/ko/docs/Web/JavaScript/Guide/Typed_arrays)에서 더 중요한데, 중간 배열에는 적절한 형식에 맞게 잘린 값이 있어야 하기 때문입니다. `Array.from()`은 {{jsxref("TypedArray.from()")}}과 동일한 동작을 하도록 구현되었습니다. +> [!NOTE] +> 이 동작은 [형식화 배열](/ko/docs/Web/JavaScript/Guide/Typed_arrays)에서 더 중요한데, 중간 배열에는 적절한 형식에 맞게 잘린 값이 있어야 하기 때문입니다. `Array.from()`은 {{jsxref("TypedArray.from()")}}과 동일한 동작을 하도록 구현되었습니다. `Array.from()` 메서드는 범용 팩토리 메서드입니다. 예를 들어, `Array`의 하위 클래스가 `from()` 메서드를 상속하는 경우, 상속된 `from()` 메서드는 `Array` 인스턴스 대신 하위 클래스의 새 인스턴스를 반환합니다. 실제로 `this` 값은 새 배열의 길이를 나타내는 단일 인수를 받는 모든 생성자 함수가 될 수 있습니다. 순회 가능이 `arrayLike`로 전달되면 인수 없이 생성자가 호출되고, 배열형 객체가 전달되면 배열형 객체의 [정규화된 length](/ko/docs/Web/JavaScript/Reference/Global_Objects/Array#length_속성_일반화)를 사용하여 생성자가 호출됩니다. 최종 `length`는 순회가 완료되면 다시 설정됩니다. `this` 값이 생성자 함수가 아닌 경우, 일반 `Array` 생성자가 대신 사용됩니다. diff --git a/files/ko/web/javascript/reference/global_objects/array/index.md b/files/ko/web/javascript/reference/global_objects/array/index.md index a79e1beec9eb55..4996ff35453bb9 100644 --- a/files/ko/web/javascript/reference/global_objects/array/index.md +++ b/files/ko/web/javascript/reference/global_objects/array/index.md @@ -379,7 +379,8 @@ f("a", "b"); // 'a+b' 이 구획은 JavaScript에서 흔히 사용되는 배열 연산에 대한 몇 가지 예제를 제공합니다. -> **참고:** 배열의 기초가 아직 익숙하지 않다면, 먼저 [JavaScript 첫걸음: 배열](/ko/docs/Learn/JavaScript/First_steps/Arrays)을 읽어보세요. 이곳은 [배열이 무엇인지](/ko/docs/Learn/JavaScript/First_steps/Arrays#배열이란) 설명하고 일반적인 배열 연산에 대한 다른 예제를 포함하고 있습니다. +> [!NOTE] +> 배열의 기초가 아직 익숙하지 않다면, 먼저 [JavaScript 첫걸음: 배열](/ko/docs/Learn/JavaScript/First_steps/Arrays)을 읽어보세요. 이곳은 [배열이 무엇인지](/ko/docs/Learn/JavaScript/First_steps/Arrays#배열이란) 설명하고 일반적인 배열 연산에 대한 다른 예제를 포함하고 있습니다. ### 배열 만들기 diff --git a/files/ko/web/javascript/reference/global_objects/array/reduce/index.md b/files/ko/web/javascript/reference/global_objects/array/reduce/index.md index 5ceadd8510e030..4d64f3a36d4576 100644 --- a/files/ko/web/javascript/reference/global_objects/array/reduce/index.md +++ b/files/ko/web/javascript/reference/global_objects/array/reduce/index.md @@ -286,7 +286,8 @@ var allbooks = friends.reduce( ### 배열의 중복 항목 제거 -> **참고:** 참고: {{jsxref("Set")}}과 {{jsxref("Array.from()")}}을 사용할 수 있는 환경이라면, `let orderedArray = Array.from(new Set(myArray));`를 사용해 중복 요소를 제거할 수도 있습니다. +> [!NOTE] +> 참고: {{jsxref("Set")}}과 {{jsxref("Array.from()")}}을 사용할 수 있는 환경이라면, `let orderedArray = Array.from(new Set(myArray));`를 사용해 중복 요소를 제거할 수도 있습니다. ```js let arr = [1, 2, 1, 2, 3, 5, 4, 5, 3, 4, 4, 4, 4]; diff --git a/files/ko/web/javascript/reference/global_objects/array/values/index.md b/files/ko/web/javascript/reference/global_objects/array/values/index.md index d36d82c3e7fc21..c13edeb783277f 100644 --- a/files/ko/web/javascript/reference/global_objects/array/values/index.md +++ b/files/ko/web/javascript/reference/global_objects/array/values/index.md @@ -62,7 +62,8 @@ console.log(iterator.next().value); // undefined ### 반복자 재사용하기 -> **Warning:** 배열 반복자 객체는 일회용 객체입니다. 재사용하지 마세요. +> [!WARNING] +> 배열 반복자 객체는 일회용 객체입니다. 재사용하지 마세요. `values()`에서 반환되는 반복자는 재사용할 수 없습니다. `next().done = true` 또는 `currentIndex > length`, [the `for...of` loop ends](/ko/docs/Web/JavaScript/Reference/Iteration_protocols#interactions_between_the_language_and_iteration_protocols) 그리고 추가적인 순회는 아무 효과가 없습니다. diff --git a/files/ko/web/javascript/reference/global_objects/atomics/wait/index.md b/files/ko/web/javascript/reference/global_objects/atomics/wait/index.md index 7d789a5374774c..14342df6ca27cc 100644 --- a/files/ko/web/javascript/reference/global_objects/atomics/wait/index.md +++ b/files/ko/web/javascript/reference/global_objects/atomics/wait/index.md @@ -11,7 +11,8 @@ l10n: 여전히 포함되어 있는지 확인합니다. 만약 그러하다면 잠자기 상태로 있으면서 깨우기(wake-up) 알림을 기다리거나 시간이 만료됩니다. 이 함수는 `"ok"`, `"not-equal"` 또는 `"timed-out"` 문자열을 반환합니다. -> **Note:** 이 연산은 공유 {{jsxref("Int32Array")}} 또는 {{jsxref("BigInt64Array")}}에서만 +> [!NOTE] +> 이 연산은 공유 {{jsxref("Int32Array")}} 또는 {{jsxref("BigInt64Array")}}에서만 > 작동하며 메인 스레드에서는 허용되지 않을 수 있습니다. > 이 메서드의 비차단, 비동기 버전에 대해서는 {{jsxref("Atomics.waitAsync()")}}를 참조하세요. diff --git a/files/ko/web/javascript/reference/global_objects/atomics/waitasync/index.md b/files/ko/web/javascript/reference/global_objects/atomics/waitasync/index.md index b3a59719028c0d..c2180e2e97ea0c 100644 --- a/files/ko/web/javascript/reference/global_objects/atomics/waitasync/index.md +++ b/files/ko/web/javascript/reference/global_objects/atomics/waitasync/index.md @@ -11,7 +11,8 @@ l10n: {{jsxref("Atomics.wait()")}}와는 다르게, `waitAsync`는 논 블록킹이며 메인 스레드에서 사용할 수 있습니다. -> **참고:** 이 작업은 오직 공유된 {{jsxref("Int32Array")}} 혹은 {{jsxref("BigInt64Array")}}에서만 동작합니다. +> [!NOTE] +> 이 작업은 오직 공유된 {{jsxref("Int32Array")}} 혹은 {{jsxref("BigInt64Array")}}에서만 동작합니다. ## 구문 diff --git a/files/ko/web/javascript/reference/global_objects/bigint/index.md b/files/ko/web/javascript/reference/global_objects/bigint/index.md index adfe090996a7bf..1fb9cc2fb47f25 100644 --- a/files/ko/web/javascript/reference/global_objects/bigint/index.md +++ b/files/ko/web/javascript/reference/global_objects/bigint/index.md @@ -78,7 +78,8 @@ bigN * -1n `/` 연산자도 정수 연산에서 예상할 수 있는 결과를 동일하게 도출합니다. 그러나 `BigInt`는 `BigDecimal`이 아니므로, 연산의 결과는 언제나 소수점 이하를 버립니다. 즉, 정수가 아닌 결과는 나오지 않습니다. -> **경고:** 소수점 결과를 포함하는 연산을 `BigInt`와 사용하면 소수점 이하는 사라집니다. +> [!WARNING] +> 소수점 결과를 포함하는 연산을 `BigInt`와 사용하면 소수점 이하는 사라집니다. ```js const expected = 4n / 2n; diff --git a/files/ko/web/javascript/reference/global_objects/bigint/tolocalestring/index.md b/files/ko/web/javascript/reference/global_objects/bigint/tolocalestring/index.md index 74314d15d65b77..71dda8e72bef79 100644 --- a/files/ko/web/javascript/reference/global_objects/bigint/tolocalestring/index.md +++ b/files/ko/web/javascript/reference/global_objects/bigint/tolocalestring/index.md @@ -47,7 +47,8 @@ toLocaleString(locales, options) `Intl.NumberFormat`를 구현한 구현체에서는 이는 `new Intl.NumberFormat(locales, options).format(number)`과 동일합니다. -> **참고:** 대부분의 경우 `toLocaleString()`이 반환하는 형식은 일관적입니다. 그러나 출력은 시간, 언어 및 구현에 따라 달라질 수 있으며, 출력 변형은 명세서에 의해 설계되고 허용됩니다. `toLocaleString()`의 결과를 정적 값과 비교해서는 안 됩니다. +> [!NOTE] +> 대부분의 경우 `toLocaleString()`이 반환하는 형식은 일관적입니다. 그러나 출력은 시간, 언어 및 구현에 따라 달라질 수 있으며, 출력 변형은 명세서에 의해 설계되고 허용됩니다. `toLocaleString()`의 결과를 정적 값과 비교해서는 안 됩니다. ## 예제 diff --git a/files/ko/web/javascript/reference/global_objects/date/date/index.md b/files/ko/web/javascript/reference/global_objects/date/date/index.md index 910e205bf97cf1..244346b3536de8 100644 --- a/files/ko/web/javascript/reference/global_objects/date/date/index.md +++ b/files/ko/web/javascript/reference/global_objects/date/date/index.md @@ -26,7 +26,8 @@ new Date(year, monthIndex, day, hours, minutes, seconds); new Date(year, monthIndex, day, hours, minutes, seconds, milliseconds); ``` -> **참고:** 새로운 `Date<` 객체를 생성하는 방법은 {{jsxref("operators/new", "new")}} 연산자를 +> [!NOTE] +> 새로운 `Date<` 객체를 생성하는 방법은 {{jsxref("operators/new", "new")}} 연산자를 > 사용하는 것이 유일합니다. `now = Date()<`처럼 `Date<`를 직접 호출하면 새로운 > `Date<` 객체가 아니라 문자열을 반환합니다. diff --git a/files/ko/web/javascript/reference/global_objects/date/index.md b/files/ko/web/javascript/reference/global_objects/date/index.md index 0f80e2ccca9996..059200789cbb9f 100644 --- a/files/ko/web/javascript/reference/global_objects/date/index.md +++ b/files/ko/web/javascript/reference/global_objects/date/index.md @@ -8,7 +8,8 @@ slug: Web/JavaScript/Reference/Global_Objects/Date JavaScript **`Date`** 객체는 시간의 한 점을 플랫폼에 종속되지 않는 형태로 나타냅니다. `Date` 객체는 1970년 1월 1일 UTC(협정 세계시) 자정과의 시간 차이를 밀리초로 나타내는 정수 값을 담습니다. -> **참고:** TC39에서 새로운 날짜/시간 API인 [Temporal](https://tc39.es/proposal-temporal/docs/index.html)을 작업 중입니다. [Igalia 블로그](https://blogs.igalia.com/compilers/2020/06/23/dates-and-times-in-javascript/)에서 더 알아보세요. 아직 프로덕션에는 적합하지 않습니다! +> [!NOTE] +> TC39에서 새로운 날짜/시간 API인 [Temporal](https://tc39.es/proposal-temporal/docs/index.html)을 작업 중입니다. [Igalia 블로그](https://blogs.igalia.com/compilers/2020/06/23/dates-and-times-in-javascript/)에서 더 알아보세요. 아직 프로덕션에는 적합하지 않습니다! ## 설명 diff --git a/files/ko/web/javascript/reference/global_objects/date/tolocaledatestring/index.md b/files/ko/web/javascript/reference/global_objects/date/tolocaledatestring/index.md index d1b01e7f380858..9d4ba50abcb98c 100644 --- a/files/ko/web/javascript/reference/global_objects/date/tolocaledatestring/index.md +++ b/files/ko/web/javascript/reference/global_objects/date/tolocaledatestring/index.md @@ -47,7 +47,8 @@ toLocaleDateString(locales, options) `Intl.DateTimeFormat`를 구현한 구현체에서는 `new Intl.DateTimeFormat(locales, options).format(date)`과 동일하며, 여기서 `options`은 위에서 설명한 대로 정규화됩니다. -> **참고:** 대부분의 경우 `toLocaleDateString()`에서 반환되는 형식은 일관적입니다. 그러나 결과는 시간, 언어 및 구현체에 따라 달라질 수 있습니다. 또한 설계에 따라 다양한 결과가 있으며 명세에서 허용됩니다. `toLocaleDateString()`의 결과를 정적 값과 비교해서는 안됩니다. +> [!NOTE] +> 대부분의 경우 `toLocaleDateString()`에서 반환되는 형식은 일관적입니다. 그러나 결과는 시간, 언어 및 구현체에 따라 달라질 수 있습니다. 또한 설계에 따라 다양한 결과가 있으며 명세에서 허용됩니다. `toLocaleDateString()`의 결과를 정적 값과 비교해서는 안됩니다. ## 예제 diff --git a/files/ko/web/javascript/reference/global_objects/date/tolocalestring/index.md b/files/ko/web/javascript/reference/global_objects/date/tolocalestring/index.md index 8def099c0bc180..d6961b95052256 100644 --- a/files/ko/web/javascript/reference/global_objects/date/tolocalestring/index.md +++ b/files/ko/web/javascript/reference/global_objects/date/tolocalestring/index.md @@ -153,7 +153,8 @@ console.log(date.toLocaleString("en-US", { hour12: false })); // IE나 Edge에서 false 입니다 ``` -> **Note:** See also this +> [!NOTE] +> See also this > [StackOverflow thread](https://stackoverflow.com/questions/25574963/ies-tolocalestring-has-strange-characters-in-results) > for more details and examples. diff --git a/files/ko/web/javascript/reference/global_objects/date/tolocaletimestring/index.md b/files/ko/web/javascript/reference/global_objects/date/tolocaletimestring/index.md index 697dcbfe55e8d1..33ca0425bfaee9 100644 --- a/files/ko/web/javascript/reference/global_objects/date/tolocaletimestring/index.md +++ b/files/ko/web/javascript/reference/global_objects/date/tolocaletimestring/index.md @@ -47,7 +47,8 @@ toLocaleTimeString(locales, options) `Intl.DateTimeFormat`를 구현한 구현체에서는 `new Intl.DateTimeFormat(locales, options).format(date)`과 동일하며, 여기서 `options`은 위에서 설명한 대로 정규화됩니다. -> **참고:** 대부분의 경우 `toLocaleTimeString()`에서 반환되는 형식은 일관적입니다. 그러나 결과는 시간, 언어 및 구현체에 따라 달라질 수 있습니다. 또한 설계에 따라 다양한 결과가 있으며 명세에서 허용됩니다. `toLocaleTimeString()`의 결과를 정적 값과 비교해서는 안 됩니다. +> [!NOTE] +> 대부분의 경우 `toLocaleTimeString()`에서 반환되는 형식은 일관적입니다. 그러나 결과는 시간, 언어 및 구현체에 따라 달라질 수 있습니다. 또한 설계에 따라 다양한 결과가 있으며 명세에서 허용됩니다. `toLocaleTimeString()`의 결과를 정적 값과 비교해서는 안 됩니다. ## 예제 diff --git a/files/ko/web/javascript/reference/global_objects/error/index.md b/files/ko/web/javascript/reference/global_objects/error/index.md index 4fbde121ee46d9..8de633f6c5e459 100644 --- a/files/ko/web/javascript/reference/global_objects/error/index.md +++ b/files/ko/web/javascript/reference/global_objects/error/index.md @@ -127,9 +127,11 @@ try { #### ES6 사용자 정의 오류 클래스 -> **경고:** Babel 버전 7 미만으로 사용자 정의 오류 클래스를 처리하려면 {{jsxref("Object.defineProperty()")}} 메서드를 사용해 정의해야만 합니다. 그렇지 않으면 오래된 Babel 및 다른 트랜스파일러가 [추가 설정](https://github.com/loganfsmyth/babel-plugin-transform-builtin-extend) 없이 코드를 처리할 수 없습니다. +> [!WARNING] +> Babel 버전 7 미만으로 사용자 정의 오류 클래스를 처리하려면 {{jsxref("Object.defineProperty()")}} 메서드를 사용해 정의해야만 합니다. 그렇지 않으면 오래된 Babel 및 다른 트랜스파일러가 [추가 설정](https://github.com/loganfsmyth/babel-plugin-transform-builtin-extend) 없이 코드를 처리할 수 없습니다. -> **참고:** ES2015 클래스를 사용할 때, 일부 브라우저는 CustomError 생성자를 스택 트레이스에 포함합니다. +> [!NOTE] +> ES2015 클래스를 사용할 때, 일부 브라우저는 CustomError 생성자를 스택 트레이스에 포함합니다. ```js class CustomError extends Error { diff --git a/files/ko/web/javascript/reference/global_objects/function/apply/index.md b/files/ko/web/javascript/reference/global_objects/function/apply/index.md index d3ce7350c31c53..aa0f62095c831a 100644 --- a/files/ko/web/javascript/reference/global_objects/function/apply/index.md +++ b/files/ko/web/javascript/reference/global_objects/function/apply/index.md @@ -7,7 +7,8 @@ slug: Web/JavaScript/Reference/Global_Objects/Function/apply **`apply()`** 메서드는 주어진 `this` 값과 배열 (또는 [유사 배열 객체](/ko/docs/Web/JavaScript/Guide/Predefined_Core_Objects#Working_with_Array-like_objects)) 로 제공되는 `arguments` 로 함수를 호출합니다. -> **참고:** 이 함수의 구문은 거의 {{jsxref("Function.call", "call()")}} 구문과 유사합니다. 근본적인 차이점은 `call()` 은 함수에 전달될 **인수 리스트**를 받는데 비해, `apply()` 는 **인수들의 단일 배열**을 받는다는 점입니다. +> [!NOTE] +> 이 함수의 구문은 거의 {{jsxref("Function.call", "call()")}} 구문과 유사합니다. 근본적인 차이점은 `call()` 은 함수에 전달될 **인수 리스트**를 받는데 비해, `apply()` 는 **인수들의 단일 배열**을 받는다는 점입니다. {{EmbedInteractiveExample("pages/js/function-apply.html")}} @@ -38,7 +39,8 @@ func.apply(thisArg, [argsArray]); ECMAScript 5번 째 판의 시작으로, 모든 유사 배열 객체 타입을 사용할 수 있으며, 실제로 이는 프로퍼티 `length` 와 범위 `(0..length-1)` 내의 정수 프로퍼티를 갖는 다는 것을 의미합니다. 예를 들면, 이제 {{domxref("NodeList")}} 또는 `{ 'length': 2, '0': 'eat', '1': 'bananas' }` 와 같은 커스텀 객체를 사용할 수 있습니다. -> **참고:** Chrome 14와 Internet Explorer 9를 포함한 대부분의 브라우저는 아직 유사배열객체를 apply에 사용할 수 없으며 오류가 출력됩니다. +> [!NOTE] +> Chrome 14와 Internet Explorer 9를 포함한 대부분의 브라우저는 아직 유사배열객체를 apply에 사용할 수 없으며 오류가 출력됩니다. ## 예제 diff --git a/files/ko/web/javascript/reference/global_objects/function/bind/index.md b/files/ko/web/javascript/reference/global_objects/function/bind/index.md index af5b605286ac43..c770f1f65c98e1 100644 --- a/files/ko/web/javascript/reference/global_objects/function/bind/index.md +++ b/files/ko/web/javascript/reference/global_objects/function/bind/index.md @@ -127,7 +127,8 @@ flower.bloom(); ### 생성자로 쓰이는 바인딩된 함수 -> **경고:** 이 부분은 JavaScript 능력을 보이고 `bind()` 메소드의 일부 극단 상황(edge case)을 기록합니다. 아래 보이는 메소드는 일을 하는 가장 좋은 방법은 아니며 아마도 상용 환경에서 전혀 사용되지 않을 겁니다. +> [!WARNING] +> 이 부분은 JavaScript 능력을 보이고 `bind()` 메소드의 일부 극단 상황(edge case)을 기록합니다. 아래 보이는 메소드는 일을 하는 가장 좋은 방법은 아니며 아마도 상용 환경에서 전혀 사용되지 않을 겁니다. 바인딩된 함수는 자동으로 대상 함수에 의해 생성되는 새로운 인스턴스를 생성하는 {{jsxref("Operators/new", "new")}} 연산자와 함께 쓰기에 적합합니다. 바인딩된 함수가 값을 생성하는 데 쓰이는 경우, 제공된 `this`는 무시됩니다. 그러나, 제공된 인수는 여전히 생성자 호출에 (인수부) 앞에 붙습니다: diff --git a/files/ko/web/javascript/reference/global_objects/function/name/index.md b/files/ko/web/javascript/reference/global_objects/function/name/index.md index b961ba16a0aad1..e595dda419abaf 100644 --- a/files/ko/web/javascript/reference/global_objects/function/name/index.md +++ b/files/ko/web/javascript/reference/global_objects/function/name/index.md @@ -15,7 +15,8 @@ slug: Web/JavaScript/Reference/Global_Objects/Function/name {{js_property_attributes(0, 0, 1)}} -> **참고:** 비표준, ES6 이전 구현에서는 `configurable` 속성 또한 `false` 였습니다. +> [!NOTE] +> 비표준, ES6 이전 구현에서는 `configurable` 속성 또한 `false` 였습니다. ## 설명 diff --git a/files/ko/web/javascript/reference/global_objects/generator/next/index.md b/files/ko/web/javascript/reference/global_objects/generator/next/index.md index 79dfa19916f317..c0daea3c82173c 100644 --- a/files/ko/web/javascript/reference/global_objects/generator/next/index.md +++ b/files/ko/web/javascript/reference/global_objects/generator/next/index.md @@ -89,7 +89,8 @@ page.next(); // Object {value: undefined, done: true} 이 예제에서는 값과 함께 `next`를 호출합니다. -> **참고:** 제너레이터가 처음에는 아무것도 생성하지 않았기 때문에 첫 번째 호출에서 기록되는 것은 없습니다. +> [!NOTE] +> 제너레이터가 처음에는 아무것도 생성하지 않았기 때문에 첫 번째 호출에서 기록되는 것은 없습니다. ```js function* gen() { diff --git a/files/ko/web/javascript/reference/global_objects/globalthis/index.md b/files/ko/web/javascript/reference/global_objects/globalthis/index.md index c254ce14697d9f..29728723a875bb 100644 --- a/files/ko/web/javascript/reference/global_objects/globalthis/index.md +++ b/files/ko/web/javascript/reference/global_objects/globalthis/index.md @@ -25,7 +25,8 @@ slug: Web/JavaScript/Reference/Global_Objects/globalThis `globalThis` 속성은 환경에 무관하게 전역 `this` 값, 즉 전역 객체에 접근하는 표준 방법을 제공합니다. `window`, `self` 등 유사한 속성과는 다르게 window와 non-window 컨텍스트 모두에서의 동작을 보장합니다. 따라서 코드를 구동하는 환경을 모르더라도 전역 객체에 일관된 방식으로 접근할 수 있습니다. 이름을 기억하는 데 도움이 되도록 전역 범위에서 `this` 값은 `globalThis`라는 점만 기억하세요. -> **참고:** 브라우저와 Node의 경우에서 `globalThis`는 일반적으로 전역 객체와 동일한 개념입니다(즉, `globalThis`에 속성을 추가하면 전역 변수가 됨). 그러나 호스트는 전역 객체와 관련이 없는 `globalThis`에 대해 다른 값을 제공할 수 있습니다. +> [!NOTE] +> 브라우저와 Node의 경우에서 `globalThis`는 일반적으로 전역 객체와 동일한 개념입니다(즉, `globalThis`에 속성을 추가하면 전역 변수가 됨). 그러나 호스트는 전역 객체와 관련이 없는 `globalThis`에 대해 다른 값을 제공할 수 있습니다. ### HTML과 WindowProxy diff --git a/files/ko/web/javascript/reference/global_objects/intl/datetimeformat/datetimeformat/index.md b/files/ko/web/javascript/reference/global_objects/intl/datetimeformat/datetimeformat/index.md index 520d93f9809aaf..ddf53320959afe 100644 --- a/files/ko/web/javascript/reference/global_objects/intl/datetimeformat/datetimeformat/index.md +++ b/files/ko/web/javascript/reference/global_objects/intl/datetimeformat/datetimeformat/index.md @@ -80,7 +80,7 @@ new Intl.DateTimeFormat(locales, options); - : (영어의 경우) "in the morning", "am", "noon", "n"처럼 시간의 위치를 나타낼 때 사용할 시간 서식입니다. "`narrow`", "`short`", " `long`" 등을 사용할 수 있습니다. - > **참고:** + > [!NOTE] > > - 12시간제 형식을 사용할 때만 결과의 차이가 있습니다. > - 한국어를 포함해, 많은 로케일에서는 지정한 너비에 상관하지 않고 같은 문자열을 반환합니다. ("새벽", "밤" 등) @@ -195,7 +195,8 @@ new Intl.DateTimeFormat(locales, options); - "`shortGeneric`" 지역을 특정하지 않는 일반적인 형식 (`PT`) - "`longGeneric`" 지역을 특정하지 않는 긴 일반적인 형식 (`Pacific Time`) - > **참고:** 요구한 형식을 사용할 수 없을 경우 시간대 서식이 다른 형태로 대체될 수 있습니다. 예를 들어 지역을 특정하지 않는 서식의 경우 특정 국가나 도시 이름을 포함하지 않아야 하지만, "Los Angeles Time"처럼 필요할 경우 이름을 포함할 수 있습니다. + > [!NOTE] + > 요구한 형식을 사용할 수 없을 경우 시간대 서식이 다른 형태로 대체될 수 있습니다. 예를 들어 지역을 특정하지 않는 서식의 경우 특정 국가나 도시 이름을 포함하지 않아야 하지만, "Los Angeles Time"처럼 필요할 경우 이름을 포함할 수 있습니다. 각 구성요소 속성의 기본값은 {{jsxref("undefined")}}입니다. 그러나 모든 속성이 `undefined`일 경우, `year`, `month`, `day`는 "`numeric`"으로 취급합니다. diff --git a/files/ko/web/javascript/reference/global_objects/intl/datetimeformat/format/index.md b/files/ko/web/javascript/reference/global_objects/intl/datetimeformat/format/index.md index 20bfa75325b6d2..eaf2e884781e58 100644 --- a/files/ko/web/javascript/reference/global_objects/intl/datetimeformat/format/index.md +++ b/files/ko/web/javascript/reference/global_objects/intl/datetimeformat/format/index.md @@ -26,7 +26,8 @@ format(date) 지정된 `date`를 나타내는 문자열로, 이 {{jsxref("Intl.DateTimeFormat")}} 객체의 로케일 및 서식 옵션에 따라 형식이 지정됩니다. -> **참고:** 대부분의 경우 `format()`이 반환하는 서식은 일관적입니다. 그러나 동일한 로케일 내에서도 구현에 따라 출력이 다를 수 있습니다. 출력 변형은 설계에 따른 것이며 사양에서 허용합니다. 또한 사용자의 예상과 다를 수도 있습니다. 예를 들어, 문자열이 줄 바꿈 없는 공백을 사용하거나 양방향 제어 문자로 둘러싸여 있을 수 있습니다. `format()`의 결과를 하드코딩된 상수와 비교해서는 안 됩니다. +> [!NOTE] +> 대부분의 경우 `format()`이 반환하는 서식은 일관적입니다. 그러나 동일한 로케일 내에서도 구현에 따라 출력이 다를 수 있습니다. 출력 변형은 설계에 따른 것이며 사양에서 허용합니다. 또한 사용자의 예상과 다를 수도 있습니다. 예를 들어, 문자열이 줄 바꿈 없는 공백을 사용하거나 양방향 제어 문자로 둘러싸여 있을 수 있습니다. `format()`의 결과를 하드코딩된 상수와 비교해서는 안 됩니다. ## 예제 diff --git a/files/ko/web/javascript/reference/global_objects/intl/locale/getcalendars/index.md b/files/ko/web/javascript/reference/global_objects/intl/locale/getcalendars/index.md index 7109a1f4f37275..ea44fe6c53f241 100644 --- a/files/ko/web/javascript/reference/global_objects/intl/locale/getcalendars/index.md +++ b/files/ko/web/javascript/reference/global_objects/intl/locale/getcalendars/index.md @@ -9,7 +9,8 @@ l10n: {{jsxref("Intl.Locale")}} 인스턴스의 **`getCalendars()`** 메서드는 이 로케일에 대한 하나 이상의 고유한 캘린더 식별자 목록을 반환합니다. -> **참고:** 일부 브라우저의 일부 버전에서는 이 메서드가 `calendars`라는 접근자 속성으로 구현되었습니다. 그러나 이 메서드는 접근할 때마다 새로운 배열을 반환하기 때문에 `locale.calendars === locale.calendars`가 `false`를 반환하는 상황을 방지하기 위해 이제 메서드로 구현되었습니다. 자세한 내용은 [브라우저 호환성 표](#브라우저_호환성)를 참조하세요. +> [!NOTE] +> 일부 브라우저의 일부 버전에서는 이 메서드가 `calendars`라는 접근자 속성으로 구현되었습니다. 그러나 이 메서드는 접근할 때마다 새로운 배열을 반환하기 때문에 `locale.calendars === locale.calendars`가 `false`를 반환하는 상황을 방지하기 위해 이제 메서드로 구현되었습니다. 자세한 내용은 [브라우저 호환성 표](#브라우저_호환성)를 참조하세요. ## 구문 diff --git a/files/ko/web/javascript/reference/global_objects/intl/locale/gettimezones/index.md b/files/ko/web/javascript/reference/global_objects/intl/locale/gettimezones/index.md index f8741a408fd16e..b4b468c013f383 100644 --- a/files/ko/web/javascript/reference/global_objects/intl/locale/gettimezones/index.md +++ b/files/ko/web/javascript/reference/global_objects/intl/locale/gettimezones/index.md @@ -9,7 +9,8 @@ l10n: {{jsxref("Intl.Locale")}} 인스턴스의 **`getTimeZones()`** 메서드는 이 로케일에 지원되는 시간대 목록을 반환합니다. -> **참고:** 일부 브라우저의 일부 버전에서는 이 메서드가 `timeZones`라는 접근자 속성으로 구현되었습니다. 그러나 이 메서드는 접근할 때마다 새로운 배열을 반환하기 때문에 `locale.timeZones === locale.timeZones`가 `false`를 반환하는 상황을 방지하기 위해 이제 메서드로 구현되었습니다. 자세한 내용은 [브라우저 호환성 표](#브라우저_호환성)를 참조하세요. +> [!NOTE] +> 일부 브라우저의 일부 버전에서는 이 메서드가 `timeZones`라는 접근자 속성으로 구현되었습니다. 그러나 이 메서드는 접근할 때마다 새로운 배열을 반환하기 때문에 `locale.timeZones === locale.timeZones`가 `false`를 반환하는 상황을 방지하기 위해 이제 메서드로 구현되었습니다. 자세한 내용은 [브라우저 호환성 표](#브라우저_호환성)를 참조하세요. ## 구문 diff --git a/files/ko/web/javascript/reference/global_objects/intl/locale/getweekinfo/index.md b/files/ko/web/javascript/reference/global_objects/intl/locale/getweekinfo/index.md index 0b891da6026519..ee0204ca1491af 100644 --- a/files/ko/web/javascript/reference/global_objects/intl/locale/getweekinfo/index.md +++ b/files/ko/web/javascript/reference/global_objects/intl/locale/getweekinfo/index.md @@ -9,7 +9,8 @@ l10n: {{jsxref("Intl.Locale")}} 인스턴스의 **`getWeekInfo()`** 메서드는 이 로케일에 대한 `firstDay`, `weekend` 및 `minimalDays` 속성을 가진 `weekInfo` 객체를 반환합니다. -> **참고:** 일부 브라우저의 일부 버전에서는 이 메서드가 `weekInfo`라는 접근자 속성으로 구현되었습니다. 그러나 이 메서드는 접근할 때마다 새로운 객체를 반환하기 때문에 `locale.weekInfo === locale.weekInfo`가 `false`를 반환하는 상황을 방지하기 위해 이제 메서드로 구현되었습니다. 자세한 내용은 [브라우저 호환성 표](#브라우저_호환성)를 참조하세요. +> [!NOTE] +> 일부 브라우저의 일부 버전에서는 이 메서드가 `weekInfo`라는 접근자 속성으로 구현되었습니다. 그러나 이 메서드는 접근할 때마다 새로운 객체를 반환하기 때문에 `locale.weekInfo === locale.weekInfo`가 `false`를 반환하는 상황을 방지하기 위해 이제 메서드로 구현되었습니다. 자세한 내용은 [브라우저 호환성 표](#브라우저_호환성)를 참조하세요. ## 구문 diff --git a/files/ko/web/javascript/reference/global_objects/intl/supportedvaluesof/index.md b/files/ko/web/javascript/reference/global_objects/intl/supportedvaluesof/index.md index 1c53c6b2abe0a1..328a344c6bd9b7 100644 --- a/files/ko/web/javascript/reference/global_objects/intl/supportedvaluesof/index.md +++ b/files/ko/web/javascript/reference/global_objects/intl/supportedvaluesof/index.md @@ -58,7 +58,8 @@ Intl.supportedValuesOf("calendar").forEach((calendar) => { }); ``` -> **참고:** calendar 값으로 반환된 배열은 항상 "gregory" (그레고리력)을 포함합니다. +> [!NOTE] +> calendar 값으로 반환된 배열은 항상 "gregory" (그레고리력)을 포함합니다. 다른 값도 동일한 방식으로 확인할 수 있습니다. diff --git a/files/ko/web/javascript/reference/global_objects/json/stringify/index.md b/files/ko/web/javascript/reference/global_objects/json/stringify/index.md index 0ab4c96bab9eb4..929f55f77db17f 100644 --- a/files/ko/web/javascript/reference/global_objects/json/stringify/index.md +++ b/files/ko/web/javascript/reference/global_objects/json/stringify/index.md @@ -165,7 +165,8 @@ JSON.stringify({ x: obj }); // '{"x":"bar"}' In a case where you want to store an object created by your user and allowing it to be restored even after the browser has been closed, the following example is a model for the applicability of `JSON.stringify()`: -> **경고:** Functions are not a valid JSON data type so they will not work. However, they can be displayed if first converted to a string (e.g. in the replacer), via the function's toString method. Also, some objects like {{jsxref("Date")}} will be a string after {{jsxref("JSON.parse()")}}. +> [!WARNING] +> Functions are not a valid JSON data type so they will not work. However, they can be displayed if first converted to a string (e.g. in the replacer), via the function's toString method. Also, some objects like {{jsxref("Date")}} will be a string after {{jsxref("JSON.parse()")}}. ```js // Creating an example of JSON diff --git a/files/ko/web/javascript/reference/global_objects/map/groupby/index.md b/files/ko/web/javascript/reference/global_objects/map/groupby/index.md index 5ff4662596b176..0f5fa667e63ad0 100644 --- a/files/ko/web/javascript/reference/global_objects/map/groupby/index.md +++ b/files/ko/web/javascript/reference/global_objects/map/groupby/index.md @@ -7,7 +7,8 @@ l10n: {{JSRef}} -> **참고:** 일부 브라우저의 일부 버전에서는 이 메서드는 `Array.prototype.groupToMap()`으로 구현되었습니다. 웹 호환성 문제때문에 현재는 정적 메서드로 구현되었습니다. 상세 내역은 [브라우저 호환성 표](#브라우저_호환성)를 확인하시기 바랍니다. +> [!NOTE] +> 일부 브라우저의 일부 버전에서는 이 메서드는 `Array.prototype.groupToMap()`으로 구현되었습니다. 웹 호환성 문제때문에 현재는 정적 메서드로 구현되었습니다. 상세 내역은 [브라우저 호환성 표](#브라우저_호환성)를 확인하시기 바랍니다. **`Map.groupBy()`** 정적 메서드는 제공된 콜백 함수가 반환한 값을 사용하여 주어진 순회 가능한 요소를 그룹화합니다. 최종적으로 반환되는 {{jsxref("Map")}}는 테스트 함수의 고유 값을 키로 사용하여 각 그룹의 요소 배열을 가져오는 데 사용할 수 있습니다. @@ -44,7 +45,8 @@ Map.groupBy(items, callbackFn) 이 방법은 시간이 지남에 따라 변경될 수 있는 특정 객체와 관련된 정보를 그룹화해야 할 때 유용합니다. 객체가 수정되더라도 반환된 `Map`의 키로 계속 작동하기 때문입니다. 대신 객체에 대한 문자열 표현을 생성하고 이를 {{jsxref("Object.groupBy()")}}의 그룹화 키로 사용하는 경우 객체가 변경되어도 원본 객체와 해당 표현 간의 매핑을 유지해야 합니다. -> **참고:** 반환된 `Map`의 그룹에 접근하려면 원래 `Map`에서 키로 사용되었던 것과 동일한 개체를 사용해야 합니다(속성을 수정할 수는 있지만 말이죠). 이름과 속성이 같은 다른 객체를 사용할 수 없습니다. +> [!NOTE] +> 반환된 `Map`의 그룹에 접근하려면 원래 `Map`에서 키로 사용되었던 것과 동일한 개체를 사용해야 합니다(속성을 수정할 수는 있지만 말이죠). 이름과 속성이 같은 다른 객체를 사용할 수 없습니다. `Map.groupBy`는 `this`의 값을 읽지 않습니다. 이 함수는 모든 객체에서 호출할 수 있으며 새로운 {{jsxref("Map")}} 인스턴스가 반환됩니다. diff --git a/files/ko/web/javascript/reference/global_objects/map/index.md b/files/ko/web/javascript/reference/global_objects/map/index.md index e813f8398149d5..6352ed08ada0eb 100644 --- a/files/ko/web/javascript/reference/global_objects/map/index.md +++ b/files/ko/web/javascript/reference/global_objects/map/index.md @@ -386,7 +386,8 @@ console.log(clone.get(1)); // one console.log(original === clone); // false (useful for shallow comparison) ``` -> **참고:** 데이터 자체는 복제가 안된다는 사실을 명심하셔야 합니다. +> [!NOTE] +> 데이터 자체는 복제가 안된다는 사실을 명심하셔야 합니다. 맵은 키 유일성을 유지한채로 병합이 가능합니다. diff --git a/files/ko/web/javascript/reference/global_objects/map/symbol.species/index.md b/files/ko/web/javascript/reference/global_objects/map/symbol.species/index.md index 81e92962e7613c..5f4658fe553460 100644 --- a/files/ko/web/javascript/reference/global_objects/map/symbol.species/index.md +++ b/files/ko/web/javascript/reference/global_objects/map/symbol.species/index.md @@ -25,7 +25,8 @@ Map[Symbol.species] `@@species` 접근자 속성은 `Map` 객체에 대한 기본 생성자를 반환합니다. 하위 클래스 생성자는 생성자 할당을 변경하기 위해 이를 재정의할 수 있습니다. -> **참고:** 이 속성은 모든 `Map` 메서드에서 현재 사용되고 있지 않습니다. +> [!NOTE] +> 이 속성은 모든 `Map` 메서드에서 현재 사용되고 있지 않습니다. ## 예제 diff --git a/files/ko/web/javascript/reference/global_objects/math/index.md b/files/ko/web/javascript/reference/global_objects/math/index.md index 2a107bd8a02737..63e6371d1b2947 100644 --- a/files/ko/web/javascript/reference/global_objects/math/index.md +++ b/files/ko/web/javascript/reference/global_objects/math/index.md @@ -38,7 +38,8 @@ slug: Web/JavaScript/Reference/Global_Objects/Math > > 라디안 값을 각도 값으로 변환하려면 `(Math.PI / 180)`으로 나누세요. 반대로 각도 값에 곱하면 라디안 값이 됩니다. -> **참고:** 많은 수의 `Math` 함수 정확도는 구현에 따라 다를 수 있습니다. +> [!NOTE] +> 많은 수의 `Math` 함수 정확도는 구현에 따라 다를 수 있습니다. > > 즉, 각 브라우저의 결과가 다를 수 있으며, 서로 같은 JS 엔진이라도 운영체제나 아키텍쳐에 따라서 불일치하는 값을 반환할 수 있습니다. diff --git a/files/ko/web/javascript/reference/global_objects/math/random/index.md b/files/ko/web/javascript/reference/global_objects/math/random/index.md index f629b3952bbb4f..1808cbb3368c57 100644 --- a/files/ko/web/javascript/reference/global_objects/math/random/index.md +++ b/files/ko/web/javascript/reference/global_objects/math/random/index.md @@ -61,7 +61,8 @@ function getRandomInt(min, max) { } ``` -> **참고:** 이 예제에서 [`Math.round()`](/ko/docs/Web/JavaScript/Reference/Global_Objects/Math/round)를 사용하고 싶을 수 있지만, 이렇게 하면 난수가 고르게 분포하지 않게 되므로 필요에 맞지 않을 수 있습니다. +> [!NOTE] +> 이 예제에서 [`Math.round()`](/ko/docs/Web/JavaScript/Reference/Global_Objects/Math/round)를 사용하고 싶을 수 있지만, 이렇게 하면 난수가 고르게 분포하지 않게 되므로 필요에 맞지 않을 수 있습니다. ### 두 수를 포함하는 두 수 사이의 정수 난수 생성하기 diff --git a/files/ko/web/javascript/reference/global_objects/object/__definegetter__/index.md b/files/ko/web/javascript/reference/global_objects/object/__definegetter__/index.md index 5783444ddf77e1..2eda259dbd12b5 100644 --- a/files/ko/web/javascript/reference/global_objects/object/__definegetter__/index.md +++ b/files/ko/web/javascript/reference/global_objects/object/__definegetter__/index.md @@ -5,7 +5,8 @@ slug: Web/JavaScript/Reference/Global_Objects/Object/__defineGetter__ {{JSRef}} -> **경고:** 이 기능은 object initializer 문법 혹은 {{jsxref("Object.defineProperty()")}} API를 사용한 getter 정의가 표준화됨으로써 비표준화되었습니다. +> [!WARNING] +> 이 기능은 object initializer 문법 혹은 {{jsxref("Object.defineProperty()")}} API를 사용한 getter 정의가 표준화됨으로써 비표준화되었습니다. > 이 기능은 이제까지의 ECMAScript 사양에서만 사용되고 있습니다. > 보다 좋은 방법이 있으므로, 이 메소드는 사용하지 말아야합니다. diff --git a/files/ko/web/javascript/reference/global_objects/object/__definesetter__/index.md b/files/ko/web/javascript/reference/global_objects/object/__definesetter__/index.md index b6eaf170263111..222e480719817a 100644 --- a/files/ko/web/javascript/reference/global_objects/object/__definesetter__/index.md +++ b/files/ko/web/javascript/reference/global_objects/object/__definesetter__/index.md @@ -7,7 +7,8 @@ l10n: {{JSRef}}{{Deprecated_Header}} -> **참고:** 이 기능은 [객체 초기자 구문](/ko/docs/Web/JavaScript/Reference/Operators/Object_initializer) 또는 {{jsxref("Object.defineProperty()")}} API를 사용하여 [설정자](/ko/docs/Web/JavaScript/Reference/Functions/set) 정의하는 것을 권장하기 때문에 이 기능은 더 이상 사용되지 않습니다. 이 메서드의 동작은 웹 호환성을 위해서만 명시되며 모든 플랫폼에서 구현할 필요는 없습니다.모든 환경에서 작동하지 않을 수도 있습니다. +> [!NOTE] +> 이 기능은 [객체 초기자 구문](/ko/docs/Web/JavaScript/Reference/Operators/Object_initializer) 또는 {{jsxref("Object.defineProperty()")}} API를 사용하여 [설정자](/ko/docs/Web/JavaScript/Reference/Functions/set) 정의하는 것을 권장하기 때문에 이 기능은 더 이상 사용되지 않습니다. 이 메서드의 동작은 웹 호환성을 위해서만 명시되며 모든 플랫폼에서 구현할 필요는 없습니다.모든 환경에서 작동하지 않을 수도 있습니다. {{jsxref("Object")}} 인스턴스의 **`__defineSetter__()`** 메서드는 해당 속성을 설정하려고 시도할 때 호출될 함수에 객체의 속성을 바인딩합니다. diff --git a/files/ko/web/javascript/reference/global_objects/object/__lookupgetter__/index.md b/files/ko/web/javascript/reference/global_objects/object/__lookupgetter__/index.md index baa5fb02102d3e..511d1bfde3085b 100644 --- a/files/ko/web/javascript/reference/global_objects/object/__lookupgetter__/index.md +++ b/files/ko/web/javascript/reference/global_objects/object/__lookupgetter__/index.md @@ -7,7 +7,8 @@ l10n: {{JSRef}} {{Deprecated_Header}} -> **참고:** 이 기능은 {{jsxref("Object.getOwnPropertyDescriptor()")}} API 사용을 선호하기 때문에 더 이상 사용되지 않습니다. 이 메서드의 동작은 웹 호환성을 위해서만 명시되며 모든 플랫폼에서 구현할 필요는 없습니다. 모든 곳에서 작동하지 않을 수도 있습니다. +> [!NOTE] +> 이 기능은 {{jsxref("Object.getOwnPropertyDescriptor()")}} API 사용을 선호하기 때문에 더 이상 사용되지 않습니다. 이 메서드의 동작은 웹 호환성을 위해서만 명시되며 모든 플랫폼에서 구현할 필요는 없습니다. 모든 곳에서 작동하지 않을 수도 있습니다. {{jsxref("Object")}} 인스턴스의 **`__lookupGetter__()`** 메서드는 지정된 속성에 접근자로 바인딩된 함수를 반환합니다. diff --git a/files/ko/web/javascript/reference/global_objects/object/__lookupsetter__/index.md b/files/ko/web/javascript/reference/global_objects/object/__lookupsetter__/index.md index a93da800b3709e..b2911ce264c92e 100644 --- a/files/ko/web/javascript/reference/global_objects/object/__lookupsetter__/index.md +++ b/files/ko/web/javascript/reference/global_objects/object/__lookupsetter__/index.md @@ -7,7 +7,8 @@ l10n: {{JSRef}} {{Deprecated_Header}} -> **참고:** 이 기능은 {{jsxref("Object.getOwnPropertyDescriptor()")}} API 사용을 선호하기 때문에 더 이상 사용되지 않습니다. 이 메서드의 동작은 웹 호환성을 위해서만 명시되며 모든 플랫폼에서 구현할 필요는 없습니다. 모든 곳에서 작동하지 않을 수도 있습니다. +> [!NOTE] +> 이 기능은 {{jsxref("Object.getOwnPropertyDescriptor()")}} API 사용을 선호하기 때문에 더 이상 사용되지 않습니다. 이 메서드의 동작은 웹 호환성을 위해서만 명시되며 모든 플랫폼에서 구현할 필요는 없습니다. 모든 곳에서 작동하지 않을 수도 있습니다. {{jsxref("Object")}} 인스턴스의 **`__lookupSetter__()`** 메서드는 지정된 속성에 설정자로 바인딩된 함수를 반환합니다. diff --git a/files/ko/web/javascript/reference/global_objects/object/defineproperty/index.md b/files/ko/web/javascript/reference/global_objects/object/defineproperty/index.md index a199146c64eb08..363696d0767c83 100644 --- a/files/ko/web/javascript/reference/global_objects/object/defineproperty/index.md +++ b/files/ko/web/javascript/reference/global_objects/object/defineproperty/index.md @@ -36,7 +36,8 @@ Object.defineProperty(obj, prop, descriptor); 데이터 서술자와 접근자 서술자는 모두 객체로, 다음의 선택적 키를 서로 공유합니다. -> **참고:** 아래에서 설명하는 **기본 값**은 `Object.defineProperty()`로 정의한 속성의 기본 동작을 의미합니다. +> [!NOTE] +> 아래에서 설명하는 **기본 값**은 `Object.defineProperty()`로 정의한 속성의 기본 동작을 의미합니다. - `configurable` - : 속성의 값을 변경할 수 있고, 객체에서 삭제할 수도 있으면 `true`입니다. **기본 값은 `false`입니다.** diff --git a/files/ko/web/javascript/reference/global_objects/object/keys/index.md b/files/ko/web/javascript/reference/global_objects/object/keys/index.md index 2b9c024b917da0..cf6f99e2451311 100644 --- a/files/ko/web/javascript/reference/global_objects/object/keys/index.md +++ b/files/ko/web/javascript/reference/global_objects/object/keys/index.md @@ -86,7 +86,8 @@ console.log(Object.keys("foo")); // ['0', '1', '2'] console.log(Object.keys(100)); // [] ``` -> **참고:** ES5에서는 비객체를 `Object.keys()`에 전달하면 {{jsxref("TypeError")}}가 발생합니다. +> [!NOTE] +> ES5에서는 비객체를 `Object.keys()`에 전달하면 {{jsxref("TypeError")}}가 발생합니다. ## 명세서 diff --git a/files/ko/web/javascript/reference/global_objects/object/valueof/index.md b/files/ko/web/javascript/reference/global_objects/object/valueof/index.md index 5af637e40c2b40..4fce1f4694f618 100644 --- a/files/ko/web/javascript/reference/global_objects/object/valueof/index.md +++ b/files/ko/web/javascript/reference/global_objects/object/valueof/index.md @@ -49,7 +49,8 @@ MyNumberType.prototype.valueOf = function () { myNumberType.valueOf(); ``` -> **참고:** 문자열 문맥에서 객체-문자열 변환은 {{jsxref("Object.toString", "toString()")}} 메서드를 사용하며, {{jsxref("String")}} 객체의 `valueOf`를 사용해 원시 문자열로 변환하는 것과는 다릅니다. 모든 객체는, 비록 결과가 "`[object type]`" 뿐이라도 문자열 변환 기능을 가지고 있습니다. 그러나 대다수의 객체는 숫자, 불리언, 함수 등으로 변환되지 않습니다. +> [!NOTE] +> 문자열 문맥에서 객체-문자열 변환은 {{jsxref("Object.toString", "toString()")}} 메서드를 사용하며, {{jsxref("String")}} 객체의 `valueOf`를 사용해 원시 문자열로 변환하는 것과는 다릅니다. 모든 객체는, 비록 결과가 "`[object type]`" 뿐이라도 문자열 변환 기능을 가지고 있습니다. 그러나 대다수의 객체는 숫자, 불리언, 함수 등으로 변환되지 않습니다. ## 예제 diff --git a/files/ko/web/javascript/reference/global_objects/promise/finally/index.md b/files/ko/web/javascript/reference/global_objects/promise/finally/index.md index 144829915c0e04..7a3ab23a6a777a 100644 --- a/files/ko/web/javascript/reference/global_objects/promise/finally/index.md +++ b/files/ko/web/javascript/reference/global_objects/promise/finally/index.md @@ -45,7 +45,8 @@ promiseInstance.finally(onFinally) {{jsxref("Promise/catch", "catch()")}}처럼 , `finally()`는 내부적으로 자신을 호출한 객체의 `then` 메소드를 호출합니다. `onFinally`가 함수가 아닌 경우, `then()`은 두 인자 모두 `onFinally`로 넘어가 호출되며, 즉 {{jsxref("Promise.prototype.then()")}}에게 유용한 처리기가 포함되지 않는다는 의미입니다. 그 외의 경우 then()은 내부적으로 생성된 두 개의 함수와 함께 호출되며, 다음과 비슷하게 동작합니다. -> **경고:** 다음은 설명을 위한 예시이며 실제 폴리필이 아닙니다. +> [!WARNING] +> 다음은 설명을 위한 예시이며 실제 폴리필이 아닙니다. ```js promise.then( diff --git a/files/ko/web/javascript/reference/global_objects/promise/index.md b/files/ko/web/javascript/reference/global_objects/promise/index.md index 9e6e363b4bfef2..87c61f6f949d7e 100644 --- a/files/ko/web/javascript/reference/global_objects/promise/index.md +++ b/files/ko/web/javascript/reference/global_objects/promise/index.md @@ -41,7 +41,8 @@ new Promise((resolveOuter) => { 이 프로미스는 생성될 때 `resolveOuter`가 동기적으로 호출되기 때문에 이미 해결되었지만, 다른 프로미스와 함께 해결되므로 1초 후 내부 프로미스가 이행될 때까지는 이행되지 않습니다. 실제로 "resolution"은 종종 백그라운드에서 이루어지며 관찰할 수 없으며, 이행 또는 거부 여부만 확인할 수 있습니다. -> **참고:** 느긋한 평가와 연산 연기를 위한 방법을 프로미스라고 부르는 언어도 여럿 존재합니다(Scheme 등). JavaScript에서의 프로미스는 콜백 함수를 연결할 수 있는, 이미 진행 중인 프로세스를 나타냅니다. 표현식을 느긋하게 평가하려면 `f = () => expression`처럼 매개변수 없는 함수를 사용해 느긋한 표현식을 생성하고, `f()`를 호출해 평가하세요. +> [!NOTE] +> 느긋한 평가와 연산 연기를 위한 방법을 프로미스라고 부르는 언어도 여럿 존재합니다(Scheme 등). JavaScript에서의 프로미스는 콜백 함수를 연결할 수 있는, 이미 진행 중인 프로세스를 나타냅니다. 표현식을 느긋하게 평가하려면 `f = () => expression`처럼 매개변수 없는 함수를 사용해 느긋한 표현식을 생성하고, `f()`를 호출해 평가하세요. ### 프로미스 연결 @@ -90,7 +91,8 @@ myPromise }); ``` -> **참고:** 실행 속도를 높이려면 모든 동기 작업을 하나의 핸들러 내에서 수행하는 것이 바람직하며, 그렇지 않으면 모든 핸들러를 순차적으로 실행하는 데 몇 틱이 걸립니다. +> [!NOTE] +> 실행 속도를 높이려면 모든 동기 작업을 하나의 핸들러 내에서 수행하는 것이 바람직하며, 그렇지 않으면 모든 핸들러를 순차적으로 실행하는 데 몇 틱이 걸립니다. 프로미스의 종료 조건에 따라 체인에서 다음 프로미스의 "settled" 상태가 결정됩니다. "fulfilled" 상태는 프로미스가 성공적으로 완료되었음을 나타내며, "rejected" 상태는 성공하지 못했음을 나타냅니다. 체인에서 이행된 각 프로미스의 반환 값은 다음 `.then()`으로 전달되고, 거부 사유는 체인의 다음 거절 핸들러 함수로 전달됩니다. @@ -468,7 +470,8 @@ if ("Promise" in window) { 위 예제에서는 현재 설정 개체를 추적하는 경우에만 `