번역 작업 진행중입니다.

새 탭을 만든다.

이것은 비동기 함수로 Promise를 돌려준다.

문법

var creating = browser.tabs.create(
  createProperties   // object
)

매개변수

createProperties
object. 새 탭에 대한 속성들. 속성들에 대해 더 배우려면 tabs.Tab 문서를 보라.
activeOptional
boolean. 활성탭이 되는지를 정한다. 윈도우의 포커스에는 영향이 없다(windows.update 참조). 기본값은 true.
cookieStoreId Optional
string. 탭의 쿠키 저장 ID를 cookieStoreId로 지정한다. 이 옵션은 확장이 "cookies" 권한을 가져야 쓸 수 있다.
indexOptional
integer. 윈도우에서 탭의 위치를 지정한다. 쓸 수 있는 값은 0에서 윈도에 있는 탭의 수까지다.
openerTabIdOptional
integer. The ID of the tab that opened this tab. If specified, the opener tab must be in the same window as the newly created tab.
openInReaderModeOptional
boolean. If true, open this tab in Reader Mode. Defaults to false.
pinnedOptional
boolean. Whether the tab should be pinned. Defaults to false.
selectedOptional
boolean. 윈도우에서 탭이 선택되는지를 지정한다. 기본값은  true.
이 속성은 사용이 중단되었다. 파이어폭스에서는 지원하지 않는다. active가 대신한다.
urlOptional
string. 최초 표시될 URL. 기본값은 새 탭 페이지다.
URL은 반드시 scheme를 포함해야 한다 (가령은 'http://www.google.com'은 되지만, 'www.google.com'은 안된다).
보안상 파이어폭스에서 특권이 있는 URL은 안된다. 그래서 아래와 같은 URL을 주면 실패할 것이다:
  • chrome: URL
  • javascript: URL
  • data: URL
  • file: URL (예, 파일시스템의 파일들. 단, 확장 안에 포함된 파일의 사용은 아래를 보라)
  • 특권이 있는 about: URL (예, about:config, about:addons, about:debugging) . 특권이 없는 URL은 된다 (예, about:blank).
  • 새 탭 페이지 (about:newtab)는 URL 값이 주어지지 않으면 열린다.

확장에 포함된 페이지의 로딩은 확장의 manifest.json 파일이 있는데서 시작하는 절대 경로를 써라. 예를 들면: '/path/to/my-page.html'. 만약 첫 '/'를 빼면 URL은 상대 경로로 취급되고, 다른 브라우저들은 다른 절대 경로를 생성해낼 것이다.

windowIdOptional
integer. 새 탭이 만들어질 윈도우. 기본값은 현재 윈도우.

Return value

A Promise that will be fulfilled with a tabs.Tab object containing details about the created tab. If the tab could not be created (for example, because url used a privileged scheme) the promise will be rejected with an error message.

브라우저 호환성

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxOperaFirefox for Android
Basic supportChrome Full support YesEdge Full support 14Firefox Full support 45Opera Full support YesFirefox Android Full support 54
createProperties.activeChrome Full support YesEdge Full support 14Firefox Full support 45Opera Full support YesFirefox Android Full support 54
createProperties.cookieStoreIdChrome No support NoEdge No support NoFirefox Full support 52Opera No support NoFirefox Android No support No
createProperties.discardedChrome No support NoEdge No support NoFirefox Full support 63Opera No support NoFirefox Android Full support 63
createProperties.indexChrome Full support YesEdge Full support 14Firefox Full support 45Opera Full support YesFirefox Android Full support 54
createProperties.openInReaderModeChrome No support NoEdge No support NoFirefox Full support 58Opera No support NoFirefox Android No support No
createProperties.openerTabIdChrome Full support 18Edge No support NoFirefox Full support 57Opera Full support 15Firefox Android No support No
createProperties.pinnedChrome Full support YesEdge No support NoFirefox Full support 45Opera Full support YesFirefox Android No support No
createProperties.selected
DeprecatedNon-standard
Chrome Full support YesEdge No support NoFirefox No support NoOpera Full support YesFirefox Android No support No
createProperties.titleChrome No support NoEdge No support NoFirefox Full support 63Opera No support NoFirefox Android Full support 63
createProperties.urlChrome Full support YesEdge Full support 14
Notes
Full support 14
Notes
Notes If the url has the 'ms-browser-extension://' protocol it is mistakenly considered a relative URL and the prefix is added redundantly, causing tab to fail loading.
Firefox Full support 45
Notes
Full support 45
Notes
Notes Before version 57, extensions were not allowed to open 'view-source:' pages.
Opera Full support YesFirefox Android Full support 54
Notes
Full support 54
Notes
Notes Before version 57, extensions were not allowed to open 'view-source:' pages.
createProperties.windowIdChrome Full support YesEdge Full support 14Firefox Full support 45Opera Full support YesFirefox Android Full support 54

Legend

Full support  
Full support
No support  
No support
Non-standard. Expect poor cross-browser support.
Non-standard. Expect poor cross-browser support.
Deprecated. Not for use in new websites.
Deprecated. Not for use in new websites.
See implementation notes.
See implementation notes.

예제

Open "https://example.org" in a new tab:

function onCreated(tab) {
  console.log(`Created new tab: ${tab.id}`)
}

function onError(error) {
  console.log(`Error: ${error}`);
}

browser.browserAction.onClicked.addListener(function() {
  var creating = browser.tabs.create({
    url:"https://example.org"
  });
  creating.then(onCreated, onError);
});

Example extensions

Acknowledgements

This API is based on Chromium's chrome.tabs API. This documentation is derived from tabs.json in the Chromium code.

Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.

문서 태그 및 공헌자

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