번역 작업 진행중입니다.

이 API는 콘텐츠 스크립트를 등록한다. 등록된 콘텐츠 스크립트는 브라우저가 URL 패턴이 일치하는 페이지에 넣는다.

이 API는 "content_scripts" manifest.json 키와 아주 비슷하다. 단지,  "content_scripts"로는 설치할 때 정해진 스크립트와 패턴을 바꿀 수 없지만, contentScripts API로는 스크립트의 등록이나 해제가 실행 중에도 가능하다.

등록할 스크립트, URL 패턴, 그리고 기타 옵션을 정의하는 객체를 인수로 contentScripts.register()을 호출하면, 반환된  PromisecontentScripts.RegisteredContentScript 객체가 인수인 완료를 수행한다.

RegisteredContentScriptregister()를 호출해 등록할 스크립트를 담는 객체다. 해제는 객체에 정의된 unregister() 메소드로 할 수 있다. 또한, 스크립트를 등록한 페이지를 없애면 스크립트는 자동으로 해제된다. 예를 들어, background 페이지에서 등록했으면 그것들은 background 페이지가 파괴될 때 자동으로 해제된다. 마찬가지로 사이드바나 팝업에서 등록했으면, 사이드바나 팝업이 닫힐 때 자동으로 해제된다.

contentScripts API 자체는 권한 없이 사용할 수 있지만, register()에 전달할 패턴에 대해서는 호스트 권한을 가져야 한다.

자료형

contentScripts.RegisteredContentScript

contentScripts.register() 함수가 반환하는 객체의 자료형으로 등록된 콘텐츠 스크립트를 표현한다. unregister() 메소드로 스스로를 해제할 수 있다.

함수

contentScripts.register()
주어진 콘텐츠 스크립트를 등록한다

브라우저 호환성

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxOperaFirefox for Android
RegisteredContentScriptChrome No support NoEdge No support NoFirefox Full support 59Opera No support NoFirefox Android Full support 59
RegisteredContentScript.unregisterChrome No support NoEdge No support NoFirefox Full support 59Opera No support NoFirefox Android Full support 59
registerChrome No support NoEdge No support NoFirefox Full support 59Opera No support NoFirefox Android Full support 59

Legend

Full support  
Full support
No support  
No support

Example extensions

문서 태그 및 공헌자

이 페이지의 공헌자: mdnwebdocs-bot, grizlupo
최종 변경자: mdnwebdocs-bot,