Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[ko] Symbol.unscopables 문서 신규 번역 #22078

Merged
merged 1 commit into from
Jul 5, 2024

Conversation

witch-factory
Copy link
Contributor

Description

Symbol.unscopables 문서를 신규 번역하였습니다.

Motivation

Additional details

unscopable의 번역어는 Array.prototype[@@unscopables]의 번역에서 "범위 지정 불가능" 으로 번역하였는데, 범위라는 단어가 스코프와 같은 뜻으로 취급되기는 어렵다고 생각하여 "스코프 지정 불가능"으로 번역하였습니다.

Related issues and pull requests

@witch-factory witch-factory requested a review from a team as a code owner June 30, 2024 11:38
@witch-factory witch-factory requested review from wisedog and removed request for a team June 30, 2024 11:38
@github-actions github-actions bot added the l10n-ko Issues related to Korean content. label Jun 30, 2024
Copy link
Contributor

github-actions bot commented Jun 30, 2024

Preview URLs

Flaws (1)

URL: /ko/docs/Web/JavaScript/Reference/Global_Objects/Symbol/unscopables
Title: Symbol.unscopables
Flaw count: 1

  • macros:
    • /ko/docs/Web/JavaScript/Reference/Statements/with does not exist but fell back to /en-US/docs/Web/JavaScript/Reference/Statements/with

(comment last updated: 2024-07-04 14:18:53)

@witch-factory
Copy link
Contributor Author

용어 안내서를 뒤늦게 확인하여 scope를 "범위"로 번역했다는 것을 확인하였습니다. 또한 스코프 웹 용어 정의등 이미 적용된 문서가 많아 여기서도 Array.prototype[@@unscopables]에서와 같이 unscopable을 "범위 지정 불가능"으로 번역하도록 수정했습니다. 이외의 scope 번역도 전부 '범위'로 수정했습니다.

Copy link
Contributor

@wisedog wisedog left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

기여 감사합니다! 의견 드렸는데요, 한 번 보시고 말씀 주십시오. 생각이 궁금합니다.


`@@unscopables` 심볼(`Symbol.unscopables`를 통해 접근)은 [`with`](/ko/docs/Web/JavaScript/Reference/Statements/with) 환경 바인딩에서 특정 속성 이름이 렉시컬 변수로 노출되지 않도록 하기 위해 어떤 객체에도 정의될 수 있습니다. [엄격 모드](/ko/docs/Web/JavaScript/Reference/Strict_mode)를 사용할 때는 `with`문을 사용할 수 없기 때문에 이 심볼이 필요하지 않을 가능성이 큽니다.

`@@unscopables` 객체의 속성을 `true`(또는 [참 같은 값](/ko/docs/Glossary/Truthy))로 설정하면 해당 속성이 `with` 범위 객체에서 '범위 지정 불가능'이 되어서 `with` 본문의 범위에 도입되지 않습니다. 속성을 `false`(또는 [거짓 같은 값](/ko/docs/Glossary/Falsy))로 설정하면 해당 속성이 '범위 지정 가능'이 되어 렉시컬 범위 변수로 나타나게 됩니다.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

렉시컬 변수가 참 번역하기 어렵네요. JavaScript 에서 렉시컬 변수는 실행 컨텍스트를 구성하는 변수인데 말이죠.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

with문의 명세를 보면 with문에 주어진 객체의 환경 레코드를 현재 실행 컨텍스트의 렉시컬 환경에 추가하고 with문 본문을 실행한 후 다시 기존의 렉시컬 환경을 복원한다고 되어 있습니다.

렉시컬 변수를 가리키는 기존의 다른 번역어가 있다면 그것으로 교체하는 것도 좋겠네요. 하지만 with문의 동작 상 실제로 with에 주어진 객체의 속성이 with문 본문에서 렉시컬 변수로 노출이 되기 때문에 의미상으로 크게 문제가 있어 보이지는 않습니다.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

아... 뭔가 변경하면 좋긴한데 좋은 단어가 떠오르지 않는군요! 감사합니다!


{{JSRef}}

`Symbol.unscopables` 정적 데이터 속성은 [잘 알려진 심볼](/ko/docs/Web/JavaScript/Reference/Global_Objects/Symbol#well-known_symbols) `@@unscopables`를 나타냅니다. {{jsxref("Statements/with", "with")}} 문은 범위 객체에서 이 심볼을 조회하여 `with` 환경 내에서 바인딩되지 않아야 하는 속성들의 집합을 포함하는 속성을 찾습니다.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

#well-known_symbols보다는 #잘_알려진_심볼 로 제목이 있다면 북마크를 정확하게 적어주시면 더 좋을듯 합니다.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

해당 부분 수정하였습니다. 감사합니다!

@witch-factory
Copy link
Contributor Author

확인이 늦어져서 죄송합니다. 코멘트 달았습니다!

@wisedog
Copy link
Contributor

wisedog commented Jul 5, 2024

LGTM!

@wisedog wisedog merged commit 3046d60 into mdn:main Jul 5, 2024
7 checks passed
@witch-factory witch-factory deleted the ko-symbol-unscopables branch July 5, 2024 04:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
l10n-ko Issues related to Korean content.
2 participants