From da78a9e329e272dedb2400b79a3bdeebff387d47 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:42:17 -0500 Subject: initial commit --- files/ko/web/api/url/index.html | 143 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 143 insertions(+) create mode 100644 files/ko/web/api/url/index.html (limited to 'files/ko/web/api/url/index.html') diff --git a/files/ko/web/api/url/index.html b/files/ko/web/api/url/index.html new file mode 100644 index 0000000000..ac29f47f05 --- /dev/null +++ b/files/ko/web/api/url/index.html @@ -0,0 +1,143 @@ +--- +title: URL +slug: Web/API/URL +tags: + - API + - Interface + - Overview + - Reference + - URI + - URL + - URL API + - Web +translation_of: Web/API/URL +--- +
{{APIRef("URL API")}}
+ +

URL 인터페이스는 {{glossary("URL")}}을 분석, 생성, 정규화, 인코딩 할 때 사용하며, URL의 각 구성요소를 쉽게 읽고 쓸 수 있는 속성을 제공합니다. URL 객체 생성은 생성자에 전체 URL 문자열, 또는 상대 URL과 기준 URL을 생성자에 전달해 진행합니다. 이렇게 생성한 URL 객체를 사용해 URL을 쉽게 바꾸거나 읽을 수 있습니다.

+ +

브라우저가 아직 {{domxref("URL.URL", "URL()")}} 생성자를 지원하지 않을 땐 {{domxref("Window")}} 인터페이스의 Window.URL 속성으로 URL 객체에 접근할 수 있습니다. 개발에 사용하기 전, 프로젝트의 지원 대상 브라우저를 확인하고, 이런 절차를 추가해야 하는지 결정하세요.

+ +

{{AvailableInWorkers}}

+ +

생성자

+ +
+
{{domxref("URL.URL", "new URL()")}}
+
주어진 절대 URL, 또는 상대 URL과 기준 URL 문자열을 사용해 생성한 URL 객체를 생성하고 반환합니다.
+
+ +

속성

+ +
+
{{domxref("URL.hash", "hash")}}
+
'#'과 URL의 프래그먼트 식별자를 담은 {{domxref("USVString")}}입니다.
+
{{domxref("URL.host", "host")}}
+
URL의 도메인(호스트 이름), ':', 포트를 담은 {{domxref("USVString")}}입니다.
+
{{domxref("URL.hostname", "hostname")}}
+
URL의 도메인을 담은 {{domxref("USVString")}}입니다.
+
{{domxref("URL.href", "href")}}
+
전체 URL을 반환하는 문자열화 속성입니다.
+
{{domxref("URL.origin", "origin")}} {{readonlyInline}}
+
URL의 {{glossary("origin", "출처")}}, 즉 스킴, 도메인, 포트를 담은 {{domxref("USVString")}}입니다.
+
{{domxref("URL.password", "password")}}
+
도메인 이름 이전에 지정된 비밀번호를 담은 {{domxref("USVString")}}입니다.
+
{{domxref("URL.pathname", "pathname")}}
+
'/'와 URL의 경로를 담은 {{domxref("USVString")}}입니다.
+
{{domxref("URL.port", "port")}}
+
URL의 포트 번호를 담은 {{domxref("USVString")}}입니다.
+
{{domxref("URL.protocol", "protocol")}}
+
URL의 {{glossary("protocol", "프로토콜")}} 스킴을 담은 {{domxref("USVString")}}입니다. 마지막 ':'을 포함합니다.
+
{{domxref("URL.search", "search")}}
+
URL의 매개변수 문자열을 나타내는 {{domxref("USVString")}}입니다. 어떤 매개변수라도 존재하는 경우 '?' 문자로 시작해, 모든 매개변수를 포함합니다.
+
{{domxref("URL.searchParams", "searchParams")}} {{readonlyInline}}
+
search 속성의 매개변수 각각에 접근할 수 있는 {{domxref("URLSearchParams")}} 객체입니다.
+
{{domxref("URL.username","username")}}
+
도메인 이름 이전에 지정된 사용자 이름을 담은 {{domxref("USVString")}}입니다.
+
+ +

메서드

+ +
+
{{domxref("URL.toString", "toString()")}}
+
전체 URL을 담은 {{domxref("USVString")}}을 반환합니다. {{domxref("URL.href")}}와 동일하나, toString()으로는 URL을 편집할 수 없습니다.
+
{{domxref("URL.toJSON", "toJSON()")}}
+
전체 URL을 담은 {{domxref("USVString")}}을 반환합니다. {{domxref("URL.href")}}와 동일한 문자열을 반환합니다.
+
+ +

정적 메서드

+ +
+
{{domxref("URL.createObjectURL", "createObjectURL()")}}
+
고유한 블롭 URL, 즉 blob: 을 스킴으로 하고, 브라우저 내의 객체를 가리키는 고유한 불투명 문자열을 그 뒤에 붙인 {{domxref("DOMString")}}을 반환합니다.
+
{{domxref("URL.revokeObjectURL", "revokeObjectURL()")}}
+
이전에 {{domxref("URL.createObjectURL()")}}로 생성한 객체 URL을 취소합니다.
+
+ +

사용 일람

+ +

생성자는 url 매개변수를 받으며, URL이 상대 URL인 경우 선택적으로 base 매개변수를 지정해 기준으로 사용할 수 있습니다.

+ +
const url = new URL('../cats', 'http://www.example.com/dogs');
+console.log(url.hostname); // "www.example.com"
+console.log(url.pathname); // "/cats"
+
+ +

URL 속성을 사용해 URL을 만들 수 있습니다.

+ +
url.hash = 'tabby';
+console.log(url.href); // "http://www.example.com/cats#tabby"
+
+ +

URL은 {{RFC(3986)}}의 규칙을 따라 인코딩 됩니다.

+ +
url.pathname = 'démonstration.html';
+console.log(url.href); // "http://www.example.com/d%C3%A9monstration.html"
+
+ +

{{domxref("URLSearchParams")}} 인터페이스를 사용해 URL 쿼리 문자열을 생성하거나 조작할 수 있습니다.

+ +

현재 URL의 검색 매개변수를 가져오려면 다음과 같은 코드를 사용하세요.

+ +
// https://some.site/?id=123
+const parsedUrl = new URL(window.location.href);
+console.log(parsedUrl.searchParams.get("id")); // "123"
+ +

{{domxref("URL.toString", "toString()")}} 메서드는 단순히 {{domxref("URL.href", "href")}} 속성의 값을 반환하는 것이므로, URL 정규화와 인코딩에 생성자를 직접 사용할 수 있습니다.

+ +
const response = await fetch(new URL('http://www.example.com/démonstration.html'));
+ +

명세

+ + + + + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('File API', '#creating-revoking', 'URL')}}{{Spec2('File API')}}Added the static methods URL.createObjectURL() and URL.revokeObjectURL().
{{SpecName('URL', '#api', 'API')}}{{Spec2('URL')}}Initial definition (implements URLUtils).
+ +

브라우저 호환성

+ + + +

{{Compat("api.URL")}}

+ +

같이 보기

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