URL.createObjectURL()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

URL.createObjectURL() 정적 메서드는 주어진 객체를 가리키는 URL을 DOMString으로 반환합니다. 해당 URL은 자신을 생성한 창의 document가 사라지면 함께 무효화됩니다.

객체 URL을 해제하려면 revokeObjectURL()을 호출하세요.

참고 : 이 기능은 Web Worker에서 사용할 수 있습니다.

참고 : 이 기능은 메모리 누수의 가능성으로 인해 Service Worker에서 사용할 수 없습니다.

구문

js
const objectURL = URL.createObjectURL(object);

매개변수

object

객체 URL을 생성할 File, Blob, MediaSource 객체.

반환 값

지정한 object의 참조 URL을 담은 DOMString

예제

사용 일람

메모리 관리

같은 객체를 사용하더라도, createObjectURL()을 매번 호출할 때마다 새로운 객체 URL을 생성합니다. 각각의 URL을 더는 쓰지 않을 땐 URL.revokeObjectURL()을 사용해 하나씩 해제해줘야 합니다.

브라우저는 불러온 문서를 해제할 때 객체 URL도 자동으로 해제합니다. 그러나 최적의 성능과 메모리 사용량을 위해서, 객체 URL을 해제해도 안전하다면 그렇게 해야 합니다.

미디어 스트림 객체 URL

구 Media Source 명세에서는 <video> 요소에 스트림을 부착하려면 MediaStream의 객체 URL을 생성했어야 했습니다. 이제 이런 과정은 필수가 아니며, 브라우저도 지원을 중단하고 있습니다.

경고: 중요: 아직 미디어 요소에 createObjectURL()을 사용해 스트림을 부착하고 있다면, srcObjectMediaStream을 직접 설정하도록 코드를 수정해야 합니다.

명세

Specification
File API
# dfn-createObjectURL

브라우저 호환성

BCD tables only load in the browser

같이 보기