클립보드 API 및 이벤트

5.2.1.1. clipboardchange 이벤트 발생 단계

Document document에 대해 clipboardchange 이벤트를 발생시키려면:

1. document에 지속적 활성화가 없고 document에 클립보드에서 읽기 권한이 없다면, 반환합니다.

2. global을 document의 관련 글로벌 객체로 둡니다.

3. document에 시스템 포커스가 있는 경우:

   1. types를 시스템 클립보드에서 사용 가능한 필수 데이터 타입의 목록으로 둡니다.

   2. changeId를 document를 인자로 하여 changeId 생성을 실행한 결과로 둡니다.

   3. eventInit를 새 ClipboardChangeEventInit 딕셔너리로 두고, types 멤버는 types로, changeId 멤버는 changeId로 설정합니다.

   4. ClipboardChangeEvent와 eventInit을 사용하여, global에서 clipboardchange라는 이름의 이벤트를 발생시킵니다.

4. document에 시스템 포커스가 없는 경우:

   1. document의 clipboardchange 보류 플래그를 true로 설정합니다.

5.2.1.2. 문서 포커스 단계

Document document가 시스템 포커스를 얻을 때:

1. document의 clipboardchange 보류 플래그가 true이면:

   1. document의 clipboardchange 보류 플래그를 false로 설정한다.

   2. types를 시스템 클립보드에서 사용 가능한 필수 데이터 타입의 목록으로 둔다.

   3. changeId를 document를 인자로 하여 changeId 생성을 실행한 결과로 둔다.

   4. eventInit을 새 ClipboardChangeEventInit 딕셔너리로 두고, types 멤버는 types로, changeId 멤버는 changeId로 설정한다.

   5. global을 document의 관련 글로벌 객체로 둔다.

   6. eventInit을 사용하여, global에서 clipboardchange라는 이름의 이벤트를 ClipboardChangeEvent로 발생시킨다.

5.2.1.3. ClipboardChangeEvent 생성자 단계

ClipboardChangeEvent(type, eventInitDict) 생성자 단계는 다음과 같습니다:

1. this.types 를 eventInitDict["types"]의 복제본(clone)으로 설정합니다.

2. this.changeId 를 eventInitDict["changeId"]로 설정합니다.

Document document에 대해 changeId 생성은 다음 단계를 따릅니다:

1. globalChangeId를 현재 시스템 클립보드 상태를 나타내는 사용자 에이전트 고유 식별자로 둡니다. 이 값은 시스템 클립보드가 변경될 때마다 바뀌며, 사용자 에이전트가 재시작되면 초기화됩니다.

2. storageKey를 document의 비스토리지 목적의 스토리지 키 얻기 실행 결과로 둡니다.

3. storageKeyBytes를 storageKey의 사용자 에이전트 고유 이진 표현으로 둡니다.

4. hashedValue를 globalChangeId(바이트)와 storageKeyBytes를 이어붙인 값에 대해 암호화 해시 함수(예: SHA-256)를 적용한 결과로 둡니다.

5. hashedValue에서 파생된 128비트 정수를 반환합니다(예: 해시 출력의 처음 128비트).

스크립트-클립보드-접근-허용 플래그는 다음과 같이 설정됩니다:

1. 동작이 복사 또는 잘라내기이고, 스크립트 스레드가 클립보드 수정 허용이면,

   1. 동작의 스크립트-클립보드-접근-허용 플래그를 설정한다

2. 동작이 붙여넣기이고, 스크립트 스레드가 클립보드 읽기 허용이면,

   1. 동작의 스크립트-클립보드-접근-허용 플래그를 설정한다.

복사 동작은 다음 단계로 구성됩니다:

1. script-triggered 플래그가 설정되어 있으면,

   1. script-may-access-clipboard 플래그가 설정되어 있지 않으면,

      1. 복사 작업에서 false를 반환하고, 이 알고리즘을 종료합니다.

2. "copy"라는 이름의 copy 클립보드 이벤트를 발생시킵니다.

3. 이벤트가 취소되지 않았다면,

   1. 선택한 내용(있는 경우)을 클립보드에 복사합니다. 구현체는 웹 페이지에서 내용이 선택되었을 때 대체 text/html 및 text/plain 클립보드 포맷을 생성하는 것이 권장됩니다.

   2. "clipboardchange"라는 이름의 clipboardchange 클립보드 이벤트를 발생시킵니다.

4. 그렇지 않고 이벤트가 취소되었다면,

   1. 클립보드에 내용 쓰기 알고리즘을 호출합니다. 이때 DataTransferItemList 리스트 items와 clear-was-called 플래그, types-to-clear 리스트를 전달합니다.

5. 복사 작업에서 true를 반환합니다.

잘라내기 동작은 다음 단계로 구성됩니다:

1. script-triggered 플래그가 설정되어 있다면,

   1. script-may-access-clipboard 플래그가 설정 해제되어 있다면,

      1. 잘라내기 작업에서 false를 반환하고, 이 알고리즘을 종료합니다.

2. "cut"라는 이름의 cut 클립보드 이벤트를 발생시킵니다.

3. 이 이벤트가 취소되지 않았다면,

   1. 선택 영역이 편집 가능한 컨텍스트 내에서 잘라내기가 활성화된 상태라면,

      1. 선택된 내용(있는 경우)을 클립보드에 복사합니다. 구현체는 웹 페이지에서 내용이 선택되었을 때 대체 text/html 및 text/plain 클립보드 포맷을 생성하는 것이 권장됩니다.

      2. 문서에서 해당 선택 영역의 내용을 제거하고 선택 영역을 축소합니다.

      3. "clipboardchange"라는 이름의 clipboardchange 클립보드 이벤트를 발생시킵니다.

      4. 변경으로 인해 발생해야 하는 모든 이벤트를 큐에 넣어 발생시키십시오. 자세한 내용은 § 5.3 다른 스크립트 및 이벤트와의 통합을 참조하세요.

   2. 그렇지 않고 선택 영역이 없거나, 컨텍스트가 편집 가능하지 않으면,

      1. false를 반환합니다.

4. 그 외에, 만약 이벤트가 취소되었다면,

   1. 클립보드에 내용 쓰기 알고리즘을 호출합니다. 이때 DataTransferItemList 리스트 items와, clear-was-called 플래그, types-to-clear 리스트를 넘깁니다.

   2. "clipboardchange"라는 이름의 clipboardchange 클립보드 이벤트를 발생시킵니다.

5. 잘라내기 작업에서 true를 반환합니다.

붙여넣기 동작은 다음 단계로 구성됩니다:

1. 스크립트-트리거됨 플래그가 설정되어 있으면,

   1. 스크립트-클립보드-접근-허용 플래그가 설정되어 있지 않으면,

      1. 붙여넣기 동작에서 false를 반환하고, 알고리즘을 종료한다

2. paste라는 이름의 클립보드 이벤트를 발생시킨다

3. 이 이벤트가 취소되지 않았으면,

   1. editable context에서 붙여넣기가 허용된 선택 영역이나 커서가 존재하면,

      1. 클립보드에서 찾은 가장 적합한 콘텐츠(있는 경우)를 해당 컨텍스트에 삽입한다.

      2. 수정으로 인해 발생해야 하는 이벤트들을 큐에 추가한다. 자세한 내용은 § 5.3 다른 스크립트 및 이벤트와의 통합을 참고한다.

   2. 그렇지 않으면

      1. false를 반환한다

4. 그렇지 않고 이벤트가 취소되었다면

   1. false를 반환한다

5. 동작에서 true를 반환한다

9.1.1. 클립보드 읽기 권한 확인

1. hasGesture를 relevant global object가 this에서 일시적 활성화(transient activation)를 가지고 있으면 true, 그렇지 않으면 false로 한다.

2. hasGesture이면,

   1. 현재 스크립트가 사용자 에이전트나 OS가 생성한 "Paste" 요소와의 사용자 상호작용 결과로 실행되고 있다면 true를 반환한다.

3. false를 반환한다.

9.2.1. 클립보드 쓰기 권한 확인

1. writeWithoutGesture를 permission state({ name: "clipboard-write", allowWithoutGesture: true } 권한 기준)로 한다.

2. writeWithoutGesture가 granted이면 true를 반환한다.

3. hasGesture를 this의 관련 글로벌 객체에 일시적 활성화(transient activation)가 있으면 true로, 그렇지 않으면 false로 둡니다.

4. hasGesture이면,

   1. 현재 스크립트가 사용자 에이전트나 OS가 생성한 "cut" 또는 "copy" 요소와의 사용자 상호작용 결과로 실행되고 있다면 systemCopy를 true로 한다.

   2. systemCopy가 true이면 true를 반환한다.

   3. request permission to use({ name: "clipboard-write", allowWithoutGesture: false } 권한 기준) 결과를 반환한다.

      참고: 사용자 에이전트는 더 강력한 권한을 요청하여 이 권한을 암묵적으로 업데이트할 수도 있습니다.

5. request permission to use({ name: "clipboard-write", allowWithoutGesture: true } 권한 기준) 결과를 반환한다.

클립보드에 콘텐츠 쓰기

입력

items : DataTransferItemList 클립보드에 쓸 아이템 리스트

clear-was-called : boolean 값

types-to-clear : 리스트

출력

없음

1. items 리스트가 비어 있지 않으면,

   1. 클립보드를 비운다

   2. 리스트의 각 파트에 대해,

      1. 데이터 타입이 text/plain이면,

         1. OS 및 로캘 관례에 따라 인코딩이 올바른지 확인

         2. 플랫폼 관례에 따라 줄바꿈을 정규화

         3. OS 클립보드 포맷 설명에 맞게 텍스트를 클립보드에 넣는다

      2. 그 외, 데이터가 필수 데이터 타입 리스트에 포함된 타입이면,

         1. OS 클립보드 포맷 설명에 맞게 파트를 클립보드에 넣는다

      3. 그 외의 경우

         1. 이는 구현체에 맡긴다...

            구현체에 맡기는 것은 바람직하지 않음. 여기서 무엇을 해야 할까?

            참고: OS 클립보드 구현의 한계로 인해, 스크립트는 커스텀 포맷이 시스템의 다른 애플리케이션에서도 사용 가능할 것이라 가정해서는 안 됩니다. 예를 들어, Microsoft Windows에서는 등록할 수 있는 커스텀 클립보드 포맷 수에 제한이 있습니다. setData()의 type 인자로 아무 문자열이나 사용할 수 있지만, 필수 데이터 타입을 사용하는 것이 강력히 권장됩니다.

2. 그 외, items 리스트가 비어 있다면, 아래와 같이 클립보드를 비울지 결정한다:

   1. 아이템 리스트가 비어 있고 clear-was-called 플래그가 true이면,

      1. types-to-clear 리스트가 비어 있으면,

         1. 클립보드를 비운다

      2. 그 외의 경우

         1. OS 및 구현체별 방식으로 types-to-clear 리스트의 타입들을 클립보드에서 제거한다

            "클립보드에서 특정 타입 제거" 기능은 위험에 처해있음. 꼭 필요하지 않고, 모든 플랫폼에서 쉽게 구현할 수 있는지 불명확함.

블롭과 옵션을 클립보드에 기록하기

입력

items — 시퀀스<Blob>

presentationStyle — 클립보드 항목의 프레젠테이션 스타일

출력

없음

1. webCustomFormats를 시퀀스<Blob>로 둡니다.

2. items의 각 item에 대해:

   1. formatString을 item의 type을 인자로 운영체제 특화 잘 알려진 포맷 알고리즘을 실행한 결과로 둡니다.

   2. formatString이 비어 있다면 다음 하위 단계를 따릅니다:

      1. webCustomFormatString을 item의 type으로 둡니다.

      2. webCustomFormat을 빈 type으로 둡니다.

      3. webCustomFormatString이 "web " 접두사로 시작한다면, "web " 접두사를 제거한 나머지 문자열을 webMimeTypeString에 저장합니다.

      4. webMimeType을 webMimeTypeString을 인자로 MIME 타입 파싱 알고리즘을 실행한 결과로 둡니다.

      5. webMimeType이 실패(failure)이면, 모든 단계를 중단합니다.

      6. webCustomFormat의 type의 essence를 webMimeType으로 지정합니다.

      7. item의 type 을 webCustomFormat으로 설정합니다.

      8. webCustomFormat을 webCustomFormats에 추가합니다.

   3. payload를 item의 바이트 시퀀스에 UTF-8 디코딩을 실행한 결과로 둡니다.

   4. payload와 presentationStyle을 formatString을 네이티브 클립보드 포맷으로 사용하여 시스템 클립보드에 삽입합니다.

   일부 OS(예: Linux "primary", "secondary", "selection")는 여러 클립보드를 가지고 있습니다. 어느 쪽에 데이터를 쓸지 정의해야 합니다.

3. 웹 커스텀 포맷 쓰기를 webCustomFormats에 대해 실행합니다.

OS별 알려진 포맷

입력

mimeType : type

출력

wellKnownFormat : 플랫폼별 문자열 타입 (Mac: NSPasteboardType, Windows: LPCWSTR, Linux: const char*)

Windows: https://docs.microsoft.com/en-us/windows/win32/dataxchg/standard-clipboard-formats 및 https://docs.microsoft.com/en-us/windows/win32/dataxchg/about-atom-tables?redirectedfrom=MSDN Mac: https://developer.apple.com/documentation/appkit/nspasteboardtype

1. wellKnownFormat을 빈 문자열로 한다.

2. mimeType의 essence가 "text/plain"이면,

   Windows에서는 다음과 같이:

   1. wellKnownFormat에 CF_UNICODETEXT 할당

   MacOS에서는 다음과 같이:

   1. wellKnownFormat에 NSPasteboardTypeString 할당

   Linux, ChromeOS, Android에서는 다음과 같이:

   1. wellKnownFormat에 "text/plain" 할당

3. 그 외, mimeType의 essence가 "text/html"이면,

   Windows에서는 다음과 같이:

   1. wellKnownFormat에 CF_HTML 할당

   MacOS에서는 다음과 같이:

   1. wellKnownFormat에 NSPasteboardTypeHTML 할당

   Linux, ChromeOS, Android에서는 다음과 같이:

   1. wellKnownFormat에 "text/html" 할당

4. 그 외, mimeType의 essence가 "image/png"이면,

   Windows에서는 다음과 같이:

   1. wellKnownFormat에 "PNG" 할당

   MacOS에서는 다음과 같이:

   1. wellKnownFormat에 NSPasteboardTypePNG 할당

   Linux, ChromeOS, Android에서는 다음과 같이:

   1. wellKnownFormat에 "image/png" 할당

5. 그 외, mimeType의 essence가 "image/svg+xml"이면,

   Windows에서는 다음과 같이:

   1. wellKnownFormat에 CFSTR_MIME_SVG_XML 할당

   MacOS에서는 다음과 같이:

   1. wellKnownFormat에 UTTypeSVG 할당

   Linux, ChromeOS, Android에서는 다음과 같이:

   1. wellKnownFormat에 "image/svg+xml" 할당

6. wellKnownFormat을 반환한다.

OS별 포맷에서 알려진 MIME 타입

입력

osFormatName : 플랫폼별 문자열 타입 (Mac: NSPasteboardType, Windows: LPCWSTR, Linux: const char*)

출력

mimeType : MIME type

Windows: https://docs.microsoft.com/en-us/windows/win32/dataxchg/standard-clipboard-formats 및 https://docs.microsoft.com/en-us/windows/win32/dataxchg/about-atom-tables?redirectedfrom=MSDN Mac: https://developer.apple.com/documentation/appkit/nspasteboardtype

Windows에서는 다음과 같이:

1. osFormatName이 "UnicodeText"면 mimeTypeString을 "text/plain"으로 설정

2. 그 외, osFormatName이 "HTML Format"이면 mimeTypeString을 "text/html"로 설정

3. 그 외, osFormatName이 "PNG"이면 mimeTypeString을 "image/png"로 설정

4. 그 외, osFormatName이 CFSTR_MIME_SVG_XML이면 mimeTypeString을 "image/svg+xml"로 설정

MacOS에서는 다음과 같이:

1. osFormatName이 NSPasteboardTypeString이면 mimeTypeString을 "text/plain"으로 설정

2. 그 외, osFormatName이 NSPasteboardTypeHTML이면 mimeTypeString을 "text/html"로 설정

3. 그 외, osFormatName이 NSPasteboardTypePNG이면 mimeTypeString을 "image/png"로 설정

4. 그 외, osFormatName이 UTTypeSVG이면 mimeTypeString을 "image/svg+xml"로 설정

Linux, ChromeOS, Android에서는 다음과 같이:

1. osFormatName이 "text/plain"이면 mimeTypeString을 "text/plain"으로 설정

2. 그 외, osFormatName이 "text/html"이면 mimeTypeString을 "text/html"로 설정

3. 그 외, osFormatName이 "image/png"이면 mimeTypeString을 "image/png"로 설정

4. 그 외, osFormatName이 "image/svg+xml"이면 mimeTypeString을 "image/svg+xml"로 설정

1. mimeType을 MIME 타입 파싱(mimeTypeString 기준) 결과로 한다.

2. mimeType을 반환한다.

웹 커스텀 포맷 읽기

입력

item, 클립보드 아이템

1. webCustomFormatMap을 OS별 커스텀 포맷 맵 이름으로 한다.

2. webCustomFormatMap을 시스템 클립보드에서 읽는다.

   webCustomFormatMap을 읽는 과정 자세히 명시 필요.

3. webCustomFormatMap이 비어 있으면 item을 반환한다.

4. webCustomFormatMapString을 webCustomFormatMap에서 역직렬화한 JSON 문자열로 한다.

   참고: webCustomFormatMap의 내용을 역직렬화할 JSON 리더 필요.

5. webCustomFormatMapString의 각 (key, value)에 대해:

   1. mimeType을 MIME 타입 파싱(key 기준) 결과로 한다.

   2. mimeType이 실패이면 루프 계속.

   3. representation을 새로운 representation으로 한다.

   4. representation의 MIME type을 mimeType으로 설정.

   5. representation의 isCustom 플래그를 true로 설정.

   6. webCustomFormat을 시스템 클립보드에서 value로 읽는다.

   7. 읽기 성공 시 representation의 data를 시스템 클립보드에서 가져온 데이터로 설정, 실패 시 루프 계속.

   8. representation을 item의 list of representations에 추가.

웹 커스텀 포맷 쓰기

입력

items, sequence<Blob>

1. idx를 0으로 초기화.

2. webCustomFormatMap을 OS별 커스텀 포맷 맵 이름으로 한다.

3. webCustomFormatMapString을 빈 JSON 문자열로 한다.

4. items의 각 item에 대해:

   1. webCustomFormat을 OS별 커스텀 포맷 이름으로 한다.

   2. webCustomFormatIdx를 idx를 webCustomFormat에 붙인 결과로 한다.

   3. item의 type 을 key로, webCustomFormatIdx을 value로 하여 webCustomFormatMapString에 JSON serializer로 삽입.

      참고: webCustomFormatMapString으로 직렬화할 JSON writer 필요.

   4. item을 시스템 클립보드에 webCustomFormatIdx 포맷으로 삽입.

   5. idx를 증가.

   6. idx가 100보다 크면 루프 종료.

5. webCustomFormatMapString을 시스템 클립보드에 webCustomFormatMap 포맷으로 삽입.

OS별 커스텀 포맷 맵 이름

출력

webCustomFormatMap, 문자열

Windows에서는 다음과 같이:

1. webCustomFormatMap에 "Web Custom Format Map" 할당.

2. webCustomFormatMap 반환.

MacOS에서는 다음과 같이:

1. webCustomFormatMap에 "org.w3.web-custom-format.map" 할당.

2. webCustomFormatMap 반환.

Linux, ChromeOS, Android에서는 다음과 같이:

1. webCustomFormatMap에 "application/web;type=\"custom/formatmap\"" 할당.

2. webCustomFormatMap 반환.

운영체제별 커스텀 이름

출력

webCustomFormat, 문자열

Windows에서는 다음 기준을 따른다:

1. webCustomFormat에 "Web Custom Format"을 할당한다.

2. webCustomFormat을 반환한다.

MacOS에서는 다음 기준을 따른다:

1. webCustomFormat에 "org.w3.web-custom-format.type-"을 할당한다.

2. webCustomFormat을 반환한다.

Linux, ChromeOS, Android에서는 다음 기준을 따른다:

1. webCustomFormat에 "application/web;type="custom/format"을 할당한다.

2. webCustomFormat을 반환한다.

클립보드 이벤트 발생시키기

입력

e, ClipboardEvent 발생시킬 이벤트

출력

없음

1. clear-was-called을 false로 한다.

2. types-to-clear를 빈 리스트로 한다.

3. clipboard-event-data를 새로운 DataTransfer 객체로, items 리스트는 빈 값으로 생성한다.

4. clipboard-entry를 현재 클립보드 콘텐츠의 시퀀스 번호로 하거나, OS 클립보드가 시퀀스 번호를 지원하지 않는 경우 null로 한다.

5. trusted를 이벤트가 사용자 에이전트에 의해 생성된 경우 true, 그렇지 않으면 false로 한다.

6. target을 다음과 같이 설정한다:

   1. 컨텍스트가 편집 가능하면,

      1. target을 선택 영역이나 커서가 있는 요소(문서 순서상)로 하거나, 선택 영역/커서가 없으면 body 요소로 한다.

   2. 그 외 컨텍스트가 편집 불가능하면,

      1. target을 포커스된 노드로 하거나, 포커스된 노드가 없으면 body 요소로 한다.

7. 이벤트를 다음과 같이 처리한다:

   1. e가 "paste"이면,

      1. clipboard-event-data의 내부 drag data store mode 플래그를 read-only로 설정한다.

      2. trusted가 true이거나, 구현체가 스크립트 생성 이벤트에 OS 클립보드 읽기 권한을 부여하도록 설정된 경우,

         1. OS 클립보드의 각 clipboard-part에 대해 아래를 수행한다:

            1. clipboard-part가 평문 텍스트를 포함하면,

               1. 텍스트가 스크립트 엔진 내부 인코딩에 맞는지 확인한다.

               2. new-data를 새로운 DataTransferItem 으로, drag data item kind는 string, drag data item type string은 text/plain으로 한다.

               3. new-data의 데이터를 평문 텍스트로 설정한다.

               4. new-data를 clipboard-event-data의 items 리스트에 추가한다.

            2. clipboard-part가 파일 참조를 나타내면, 각 파일 참조에 대해:

               1. 참조된 파일의 MIME 타입을 결정한다.

               2. new-data를 새로운 DataTransferItem 으로, drag data item kind는 file, drag data item type string은 해당 MIME 타입(모르면 application/octet-stream)으로 한다.

               3. new-data의 데이터를 파일 참조 데이터로 설정한다.

               4. new-data를 clipboard-event-data의 items 리스트에 추가한다.

            3. clipboard-part가 HTML 또는 XHTML 형식의 텍스트를 포함하면(OS 클립보드 포맷 설명 기준),

               1. 구현체가 HTML 붙여넣기를 지원하면, HTML 붙여넣기 이벤트 처리(clipboard-part, clipboard-event-data)를 호출한다.

            4. clipboard-part가 다른 지원되는 바이너리 혹은 텍스트 기반 포맷(see 필수 데이터 타입)의 데이터를 포함하면,

               1. 데이터의 MIME 타입 결정

               2. new-data를 새로운 DataTransferItem 으로, drag data item kind는 file, drag data item type string은 해당 MIME 타입으로 한다.

               3. new-data의 데이터를 바이너리 또는 텍스트 기반 데이터로 설정한다.

               4. new-data를 clipboard-event-data의 items 리스트에 추가한다.

      3. clipboard-event-data의 files 속성을 clipboard-event-data의 items 항목에 맞게 갱신한다.

      4. clipboard-event-data의 types 속성을 clipboard-event-data의 items 항목에 맞게 갱신한다.

   2. e가 "copy" 또는 "cut"이면,

      1. 해당 DataTransfer 객체의 내부 drag data store mode 플래그를 read/write로 한다.

8. e의 clipboardData 를 clipboard-event-data로 설정한다.

9. e의 isTrusted 를 trusted로 설정한다.

10. e의 composed 를 true로 설정한다.

11. 이벤트 e를 target에 버블링되고 취소 가능한 이벤트로, ClipboardEvent 인터페이스로 디스패치한다.

    이벤트 디스패치 중 데이터 접근에 대한 구현 요구사항은 [HTML]에 정의되어 있다. 추가적인 클립보드 이벤트 전용 처리 규칙은 아래와 같다:

    왜 여기서 정의하는가? 왜 HTML 명세에 포함되지 않는가?

    1. 스크립트가 clearData() 또는 clear() 를 호출하고, DataTransfer 객체 내부 drag data store mode 플래그가 read/write이면,

       1. clear-was-called 플래그를 true로 설정한다. 인자가 주어지면 해당 인자를 types-to-clear 리스트에 추가한다.

    2. 스크립트가 setData()를 호출하거나 아이템을 수정하고, clear-was-called 플래그가 true이면,

       1. types-to-clear 리스트가 비어있으면,

          1. clear-was-called 플래그를 false로 한다.

       2. 그 외, setData()의 type 인자 또는 새 아이템의 drag data item type string이 types-to-clear 리스트에 있다면,

          1. 리스트에서 해당 항목을 제거하고, 리스트가 비어있으면 clear-was-called 플래그를 false로 한다.

    3. 스크립트가 getData()를 호출하거나 DataTransferItemList 에 접근하고 clipboard-entry가 설정되어 있으면,

       1. 클립보드 데이터의 시퀀스 번호가 clipboard-entry와 일치하는지 확인한다. 클립보드가 더 이상 동일한 항목을 포함하지 않으면 DataTransferItemList 객체의 내부 drag data store mode를 protected로 설정한다.

    경고! paste 이벤트를 감시하는 악성 스크립트가 사용자가 미래에 클립보드에 넣는 것을 무한 반복 루프를 통해 읽을 수 있습니다. 클립보드 시퀀스 번호를 지원하지 않는 플랫폼에서는 추가 제한이 필요합니다.

HTML 붙여넣기 이벤트 처리

입력

clipboard-part, 처리할 클립보드 파트

clipboard-event-data, 이 이벤트용 DataTransfer 객체

출력

없음

1. new-data를 새로운 DataTransferItem 으로, drag data item kind는 Plain Unicode string, drag data item type string은 text/html 또는 application/xhtml+xml로 한다.

2. clipboard-part에서 마크업을 추출하고, 관련 파서를 사용해 DOM 트리를 생성한다.

3. 마크업의 소스 URL이 알려져 있다면, HREF와 SRC 속성의 상대 URL을 소스 URL을 기준으로 모두 절대 URL로 변환해 해당 속성에 설정한다.

4. 마크업의 출처가 로컬 애플리케이션이라면, 로컬 파일이나 OS 클립보드의 다른 부분을 참조하는지 확인한다. 참조가 있다면, 서브파트 참조는 반드시 cid: URL 스킴([RFC2392])을 활용해 content-id 참조로 바꿔야 한다. 이를 위해 아래 단계를 따른다:

   이 단계가 필요한가? 내부 참조가 있는 다중 파트 지원 네이티브(플랫폼) 클립보드 구현이 존재하는가?

   이 기능은 꼭 필요한지, 그리고 크로스 플랫폼 테스트가 어렵기 때문에 위험에 처해있음.

   1. clipboard-event-data의 items 에 이미 참조된 파일 또는 클립보드 파트에 대한 항목이 있으면,

      1. itemNumber를 해당 항목의 인덱스로 설정한다.

   2. 그렇지 않으면,

      1. new-file-data를 새 DataTransferItem 객체로 하고, drag data item kind는 "file"로, drag data item type string은 파일 또는 클립보드 파트의 MIME 타입(알 수 없다면 application/octet-stream)으로 설정한다.

      2. file-info를 새 File 객체로 하며, name 은 HTML 속성 값의 이름 부분으로, lastModified 는 참조된 파일의 타임스탬프 또는 클립보드 파트라면 0으로 설정한다.

      3. new-file-data의 내부 File 객체를 file-info로 설정한다.

      4. new-file-data를 clipboard-event-data의 items 에 추가하고, itemNumber를 DataTransferItemList에서 해당 항목의 인덱스로 한다.

   3. 로컬 파일 또는 클립보드 파트를 참조하는 DOM 속성을 'cid:'와 itemNumber로 갱신한다.

5. 처리된 DOM을 직렬화하여 new-data에 생성된 HTML 코드로 갱신한다.

6. new-data를 clipboard-event-data의 items 에 추가한다.