WINDOW

settings_applicationsEventTarget  >   settings_applicationsCookieStore  >   settings_applications[[Prototype]]

WINDOW

Editing
  • account_tree
  • bug_report

Promisepromiseset(stringname, stringvalue | Objectoptions)

지정된 이름과 값을 갖거나 옵션으로 지정된 객체를 쿠키로 설정한다.

설명

이 기능은 Web Workers에서 사용이 가능하다.
이 기능은 웹브라우저에 따라 HTTPS 보안 컨텍스트에서만 사용이 가능하다.

구문

형식
window.cookieStore.set(name, value)
형식
window.cookieStore.set(options)

매개 변수

Use of parameters type 1
stringname필수

쿠키의 이름을 지정한다.

stringvalue필수

쿠키의 값을 지정한다.

Use of parameters type 2
Objectoptions필수

다음과 같은 프로퍼티가 포함되어 있는 객체를 지정한다.

domain
선택적인 프로퍼티이며 쿠키의 도메인을 포함하는 문자열을 나타낸다. 기본값은 null이다.
expires
선택적인 프로퍼티이며 쿠키의 만료 시간을 포함하는 밀리초 단위의 유닉스 타임을 나타낸다. 기본값은 null이다.
name
필수 프로퍼티이며 쿠키 이름을 나타낸다.
partitioned
선택적인 프로퍼티이며 쿠키의 분할 여부를 불리언(boolean)으로 나타낸다. true이면 분할된 쿠키임을 나타낸다. 기본값은 false이다.
path
선택적인 프로퍼티이며 쿠키의 경로를 나타낸다. 기본값은 /이다.
sameSite
선택적인 프로퍼티이며 다음의 값 중의 하나를 지정한다.
"strict"
기본값이며 쿠키는 자사 컨텍스트에서만 전송되며 3자의 웹사이트에서 시작된 요청과 함께 전송되지 않는다.
"lax"
쿠키는 일반적인 교차 웹사이트  하위 요청에서 전송되지 않지만 사용자가 원본 웹사이트 내에서 탐색할 때 전송된다.
"none"
쿠키는 모든 상황에서 전송된다.
value
필수적인 프로퍼티이며 쿠키 값을 나타낸다.
About Object Type

Object() 생성자 함수에 의해서 생성이 된 인스턴스이거나 객체 리터럴로 생성된 데이터를 나타낸다.

반환

Promisepromise

쿠키 설정이 완료되면 undefined로 이행되는 Promise 객체를 반환한다.

Exception

DOMException

DOM API의 메소드를 호출하거나 프로퍼티에 접근한 결과 발생하는 비정상적인 이벤트(예외)를 나타낸다.

SecurityError

작업이 보안에 취약함을 나타낸다.

TypeError

동적 타입의 값이 흐름상 맞지 않는 자료형이라 연산을 할 수 없을 때 발생하는 오류를 다루는 객체이다.

버전 명세

Cookie Store API
#dom-cookiestore-set

지원 웹브라우저