정확성 때문에 버린 최적화는 다시 잰다

예전에 정확성 때문에 쓰지 않았던 직렬화 방식을, 입력 한 자가 무거워져 다시 써 봤습니다. 편집 문서 안에서 저장용 HTML을 만들면 쌓여 있는 Range를 브라우저가 같이 다루느라 입력이 밀릴 수 있어, document.implementation.createHTMLDocument로 분리된 문서를 만들고 그쪽에서 읽기로 했습니다. 처음 에디터를 만들 때 이 방법을 사용하지 않았던 이유는, 저장되는 문자열이 달라질 수 있다고 봤기 때문입니다. 다시 넣어 보니 입력 한 자의 멈춤은 줄었고, 그래서 문자열이 실제로 갈리는지부터 나눠 재기로 했습니다.

이 글은 에디터에서 저장용 HTML을 만드는 비용이 입력을 밀 때, 분리된 문서에서 직렬화해도 되는지를 가려야 하는 분께 도움이 됩니다.

한눈에 보는 결론

  • 제약: 저장 문자열과 미리보기·발행 결과가 조용히 바뀌면 안 됩니다.
  • 결정: 분리된 문서에서 innerHTML처럼 속성 그대로 읽는 경로인지를 확인한 뒤에 다시 씁니다.
  • 확인: innerHTML은 두 문서에서 같았고, href·src 프로퍼티와 XMLSerializer만 갈렸습니다. 실험용 페이지에서 단락 350개와 Range 8만 개 기준 중앙값은 3ms와 0.2ms였고, 입력 한 자의 멈춤이 줄어드는 것도 확인했습니다.

과제와 제약

목표는 글 쓰는 화면에서 입력 한 자가 멈추는 시간을 줄이되, 저장한 HTML을 다시 열었을 때 화면과 문자열이 이전과 같게 두는 것입니다. 직렬화 비용을 피하는 일과, 저장 결과가 같은지는 다른 축이라, 속도만 보고 넣을 수는 없었습니다.

제약에 맞춰 고른 방법

선택지는 세 가지였습니다. 편집 문서에서 계속 직렬화하면 저장 결과는 그대로지만, Range가 쌓일수록 입력은 무거워질 수 있습니다. 분리된 문서에서 읽되 출력 비교를 생략하면 속도는 나지만, 저장된 HTML이 바뀌면 미리보기와 발행에 구멍이 납니다. 그래서 분리된 문서에서 만들되, 저장 결과가 같은 경로인지를 확인하고 쓰는 쪽을 택했습니다.

이 방법을 계속 쓰지 않는 편과, 체감만 보고 넣는 편은 쓰지 않기로 했습니다.

기본 구조

Tiptap의 getHTML은 편집 중인 문서를 HTML로 돌려 줍니다. 그 아래의 ProseMirror DOMSerializer.serializeFragment는 document 옵션을 받을 수 있고, 공식 문서는 브라우저가 아닐 때 노드를 만들 문서를 넘기라고 적습니다. createHTMLDocument가 만드는 문서는 지금 페이지와 분리되어 있고, 기준 주소는 about:blank입니다.

저장 HTML은 읽기 방법에 따라 갈릴 수 있다

실제 고친 모양은, 분리된 문서에서 노드를 옮긴 뒤 innerHTML로만 읽는 함수입니다. href나 src 프로퍼티를 속성에 다시 쓰지 않습니다.

function serializeForSave(source) {
  const detached = document.implementation.createHTMLDocument('')
  const wrap = detached.createElement('div')
  wrap.appendChild(detached.importNode(source, true))
  return wrap.innerHTML
}

같은 마크업을 편집 문서와 분리된 문서에서 innerHTML로 읽으면 문자열이 같았습니다. href와 src 프로퍼티를 속성에 다시 쓰면 편집 문서에서는 https://example.com/about처럼 풀리고, 분리된 문서에서는 /about으로 남았습니다. XMLSerializer로 br을 읽으면 두 문서 모두 <br xmlns="http://www.w3.org/1999/xhtml" />가 되고, outerHTML은 <br>입니다.

다시 넣기까지

예전에 이 방법을 사용하지 않았던 이유

처음 에디터를 만들 때는, 분리된 문서에서 읽으면 저장 문자열이 달라질 수 있다고 보고 이 방식을 버렸습니다. 정확성을 지키려는 선택이었습니다.

다시 넣은 뒤 가벼워진 입력

입력 한 자가 무거워져, 예전에 버린 방식을 다시 넣었습니다. 속도가 나을 거라고 봤고, 실제로 입력 한 자의 멈춤은 줄었습니다.

읽기 경로에 따라 갈린 저장 문자열

그래서 버린 이유가 지금도 같은지 다시 쟀습니다. innerHTML처럼 속성 그대로 읽는 경로는 두 문서에서 같았고, 갈린 것은 확인된 읽기 방법뿐이었습니다. 같은 경로를 확인한 뒤에야 이 방식을 다시 쓸 수 있다고 봤습니다.

한계

분리된 문서의 기준 주소는 about:blank라, 상대 주소를 프로퍼티로 풀어 저장하면 결과가 갈립니다. XMLSerializer는 HTML이 아니라 XML 표기를 돌려 주므로, outerHTML이나 innerHTML과 같은 문자열이라고 보면 안 됩니다.

확인 방법

굵게, 기울임, 링크, 이미지, 목록처럼 실제로 쓰는 서식을 한 번씩 넣고, 저장한 뒤 다시 열었을 때 화면과 문자열이 같은지 봅니다. href·src를 절대 주소로 풀어 쓰거나 XMLSerializer로 저장하는 경로가 있으면 그 차이까지 대조합니다. 그리고 한 자 입력으로 멈춤이 줄었는지를 같이 봅니다.

저는 입력 한 자의 멈춤이 줄어든 것만으로 다시 쓰기로 결정하지 않았습니다. 예전에 버린 이유가 저장 문자열이 달라질 수 있다는 점이었고, 다시 재어 보니 innerHTML은 같았으며, 갈린 것은 href·src 프로퍼티와 XMLSerializer뿐이었습니다. 저장 문자열이 같은지 먼저 확인했고, 직접 입력해 보는 테스트에서도 UX 문제는 없었습니다.

정리

  • 분리된 문서에서 innerHTML로 읽으면 편집 문서와 같았습니다.
  • href·src 프로퍼티와 XMLSerializer는 갈리므로, 그 경로인지를 먼저 가릅니다.
  • 속도만 보고 다시 넣지는 않습니다.

정확성 때문에 버린 최적화는, 버린 이유와 지금 출력부터 다시 재려고 합니다.

참고

← 일일 회고