Async Clipboard API의 정리되지 않은 HTML

Chrome 120부터 비동기 클립보드 API에서 새로운 unsanitized 옵션을 사용할 수 있습니다. 이 옵션은 HTML을 사용하는 특수한 상황에서 클립보드의 콘텐츠를 복사했을 때와 동일하게 붙여넣어야 하는 경우에 유용합니다. 즉, 브라우저가 일반적으로 적용하는 중간 정제 단계가 없습니다. 이 가이드에서 사용 방법을 알아보세요.

Async Clipboard API를 사용할 때 대부분의 경우 개발자는 클립보드에 있는 콘텐츠의 무결성에 대해 걱정할 필요가 없으며 클립보드에 쓰는(복사) 내용이 클립보드에서 데이터를 읽을 때(붙여넣기) 가져오는 내용과 동일하다고 가정할 수 있습니다.

텍스트의 경우 특히 그렇습니다. DevTools 콘솔에 다음 코드를 붙여넣은 다음 페이지에 즉시 다시 포커스를 맞춥니다. (setTimeout()는 페이지에 포커스를 맞출 충분한 시간을 확보하기 위해 필요하며, 이는 Async Clipboard API의 요구사항입니다.) 보시다시피 입력은 출력과 정확히 동일합니다.

setTimeout(async () => {
  const input = 'Hello';
  await navigator.clipboard.writeText(input);
  const output = await navigator.clipboard.readText();
  console.log(input, output, input === output);
  // Logs "Hello Hello true".
}, 3000);

이미지의 경우 약간 다릅니다. 이른바 압축 폭탄 공격을 방지하기 위해 브라우저는 PNG와 같은 이미지를 다시 인코딩하지만 입력 이미지와 출력 이미지는 시각적으로 픽셀 단위로 정확히 동일합니다.

setTimeout(async () => {
  const dataURL =
    'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVQYV2NgYAAAAAMAAWgmWQ0AAAAASUVORK5CYII=';
  const input = await fetch(dataURL).then((response) => response.blob());
  await navigator.clipboard.write([
    new ClipboardItem({
      [input.type]: input,
    }),
  ]);
  const [clipboardItem] = await navigator.clipboard.read();
  const output = await clipboardItem.getType(input.type);
  console.log(input.size, output.size, input.type === output.type);
  // Logs "68 161 true".
}, 3000);

HTML 텍스트는 어떻게 될까요? 짐작하셨겠지만 HTML의 경우 상황이 다릅니다. 여기에서 브라우저는 HTML 코드에서 <script> 태그(및 <meta>, <head>, <style>과 같은 기타 태그)를 제거하고 CSS를 인라인 처리하는 등의 방법으로 HTML 코드를 정제하여 문제가 발생하지 않도록 합니다. 다음 예를 참고하여 DevTools 콘솔에서 사용해 보세요. 출력이 입력과 상당히 다르다는 것을 알 수 있습니다.

setTimeout(async () => {
  const input = `<html>  
  <head>  
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />  
    <meta name="ProgId" content="Excel.Sheet" />  
    <meta name="Generator" content="Microsoft Excel 15" />  
    <style>  
      body {  
        font-family: HK Grotesk;  
        background-color: var(--color-bg);  
      }  
    </style>  
  </head>  
  <body>  
    <div>hello</div>  
  </body>  
</html>`;
  const inputBlob = new Blob([input], { type: 'text/html' });
  await navigator.clipboard.write([
    new ClipboardItem({
      'text/html': inputBlob,
    }),
  ]);
  const [clipboardItem] = await navigator.clipboard.read();
  const outputBlob = await clipboardItem.getType('text/html');
  const output = await outputBlob.text();
  console.log(input, output);
}, 3000);

HTML 정리는 일반적으로 좋은 방법입니다. 대부분의 경우 정리되지 않은 HTML을 허용하여 보안 문제에 노출되는 것을 원하지 않습니다. 하지만 개발자가 자신이 무엇을 하고 있는지 정확히 알고 있고 입력 및 출력 HTML의 무결성이 앱의 올바른 작동에 중요한 시나리오가 있습니다. 이러한 상황에서는 다음 두 가지 선택지가 있습니다.

  1. 복사와 붙여넣기를 모두 제어하는 경우(예: 앱 내에서 복사한 후 앱 내에 붙여넣는 경우) Async Clipboard API의 웹 맞춤 형식을 사용해야 합니다. 여기까지만 읽고 링크로 연결된 도움말을 확인하세요.
  2. 앱에서 붙여넣기 끝만 제어하고 복사 끝은 제어하지 않는 경우(웹 맞춤 형식을 지원하지 않는 네이티브 앱에서 복사 작업이 발생하기 때문일 수 있음) 이 문서의 나머지 부분에서 설명하는 unsanitized 옵션을 사용해야 합니다.

정리에는 script 태그 삭제, 인라인 스타일, HTML의 올바른 형식 확인 등이 포함됩니다. 이 목록은 전체 목록이 아니며 향후 단계가 더 추가될 수 있습니다.

정제되지 않은 HTML 복사 및 붙여넣기

Async Clipboard API를 사용하여 HTML을 클립보드에 write() (복사)하면 브라우저는 DOM 파서를 통해 실행하고 결과 HTML 문자열을 직렬화하여 형식이 올바른지 확인하지만 이 단계에서는 정리 작업이 수행되지 않습니다. 별도의 조치가 필요하지 않습니다. 다른 애플리케이션에서 클립보드에 배치한 HTML을 read()하고 웹 앱이 전체 품질 콘텐츠를 가져오도록 선택하고 자체 코드에서 정리 작업을 수행해야 하는 경우 unsanitized 속성과 ['text/html'] 값을 사용하여 옵션 객체를 read() 메서드에 전달할 수 있습니다. 단독으로 보면 다음과 같습니다. navigator.clipboard.read({ unsanitized: ['text/html'] }) 아래의 코드 샘플은 이전에 표시된 것과 거의 동일하지만 이번에는 unsanitized 옵션이 있습니다. DevTools 콘솔에서 시도하면 입력과 출력이 동일한 것을 확인할 수 있습니다.

setTimeout(async () => {
  const input = `<html>  
  <head>  
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />  
    <meta name="ProgId" content="Excel.Sheet" />  
    <meta name="Generator" content="Microsoft Excel 15" />  
    <style>  
      body {  
        font-family: HK Grotesk;  
        background-color: var(--color-bg);  
      }  
    </style>  
  </head>  
  <body>  
    <div>hello</div>  
  </body>  
</html>`;
  const inputBlob = new Blob([input], { type: 'text/html' });
  await navigator.clipboard.write([
    new ClipboardItem({
      'text/html': inputBlob,
    }),
  ]);
  const [clipboardItem] = await navigator.clipboard.read({
    unsanitized: ['text/html'],
  });
  const outputBlob = await clipboardItem.getType('text/html');
  const output = await outputBlob.text();
  console.log(input, output);
}, 3000);

브라우저 지원 및 기능 감지

기능이 지원되는지 직접 확인할 수 있는 방법은 없으므로 기능 감지는 동작을 관찰하는 것을 기반으로 합니다. 따라서 다음 예는 <style> 태그가 유지되는지(지원됨을 나타냄) 또는 인라인 처리되는지(지원되지 않음을 나타냄)를 감지하는 데 의존합니다. 이 기능이 작동하려면 페이지에서 이미 클립보드 권한을 가져와야 합니다.

const supportsUnsanitized = async () => {
  const input = `<style>p{color:red}</style><p>a`;
  const inputBlob = new Blob([input], { type: 'text/html' });
  await navigator.clipboard.write([
    new ClipboardItem({
      'text/html': inputBlob,
    }),
  ]);
  const [clipboardItem] = await navigator.clipboard.read({
    unsanitized: ['text/html'],
  });
  const outputBlob = await clipboardItem.getType('text/html');
  const output = await outputBlob.text();
  return /<style>/.test(output);
};

데모

unsanitized 옵션의 작동 모습을 보려면 데모를 참고하고 소스 코드를 확인하세요.

결론

소개에서 설명한 것처럼 대부분의 개발자는 클립보드 삭제에 대해 걱정할 필요가 없으며 브라우저에서 선택한 기본 삭제 옵션을 사용하면 됩니다. 개발자가 주의해야 하는 드문 경우를 위해 unsanitized 옵션이 있습니다.

감사의 말씀

이 도움말은 Anupam Snigdha 및 Rachel Andrew가 검토했습니다. 이 API는 Microsoft Edge팀에서 지정하고 구현했습니다.