Support "message_serialization": "structured_clone" for extension messaging
Component: WebKit Web Extensions | e8d9b34
Source/WebKit/Shared/Extensions/WebExtensionContextParameters.serialization.in
Source/WebKit/Shared/Extensions/WebExtensionContextParameters.h
Source/WebKit/CMakeLists.txt
Web extension API는 background, content script, popup 같은 WebContent process에서 실행됩니다. 이들 사이의 messaging은 UIProcess가 중개합니다. 먼저 송신 측 process가 runtimeSendMessage, tabsSendMessage, portPostMessage 같은 IPC handler를 호출합니다. 그러면 UIProcess가 대상의 WebExtensionContextProxy로 메시지를 전달합니다.
지금까지 payload는 항상 JSON 문자열이었고, 그 자체로는 아무 동작도 하지 않는 텍스트에 불과했습니다. 반면 SerializedScriptValue는 postMessage가 사용하는 structured-clone wire format입니다. typed array, Map, Blob 등 복잡한 객체를 담을 수 있으며, 수신 측에서는 실제 JS 객체로 deserialize됩니다.
이번 commit에서는 message_serialization manifest key가 추가되었습니다. 값이 structured_clone이면 runtime.sendMessage, tabs.sendMessage, Port.postMessage가 SerializedScriptValue로 직렬화를 수행합니다. 이때 메시지와 reply는 새로 정의된 WebExtensionMessage IPC 타입으로 전달되는데, 이 타입은 JSON 문자열과 SerializedScriptValue 중 하나를 담습니다. 수신 측도 두 형식을 모두 받아들이도록 변경되었습니다.
또한 reply 타입이 std::optional로 바뀌었습니다. manifest 값이 유효하지 않으면 InvalidManifestEntry가 기록되고 JSON으로 fallback합니다. 한편 web page와 native app에는 opt-in에 사용할 manifest가 없으므로, 해당 경로는 JSON을 그대로 유지합니다.
Significance
이제 extension은 base64로 잘게 나눠 보내지 않고도 ArrayBuffer, Map, Date, Blob을 context 간에 전달할 수 있습니다. Blob 참조를 포함한 structured-clone payload가 새로운 IPC variant 타입을 통해 WebContent → UIProcess → WebContent 경로를 넘나들게 되었습니다.
Audit directions
새 variant 타입은 compromised sender가 도달할 수 있는 deserialization 경로이자 relay 경로입니다.
runtimeSendMessage,tabsSendMessage,portPostMessage가 variant를 어떻게 다루는지 살펴볼 필요가 있습니다. 내용을 검증하거나 검사하는지, 그리고 두 alternative 모두에서length()가 일관되게 계산되는지 확인해야 합니다.- compromised sender가 opt-in하지 않은 수신 측에 structured clone을 강제로 보낼 수 있는지 점검이 필요합니다. JSON을 유지해야 하는 native port와 web page 대상도 같은 기준으로 확인해야 합니다.
- Blob lifetime도 점검 대상입니다. 송신 측은 reply가 도착할 때까지 메시지를 유지합니다. 다만 reply, 단방향 전송, port 메시지, 조기 disconnect에서는 같은 보장이 성립하지 않을 가능성이 있습니다.
- 수신 측에서
toJSValue로 extension의 global object(content script 및 isolated world)에 deserialize하는 과정을 살펴봐야 합니다. 실패 시 처리와 exception 처리도 여기에 포함됩니다. std::optionalreply는 reply가 없는 경우와 빈 reply를 구분합니다. 모든 호출 지점과 callback에서 이 구분이 일관되게 처리되는지 확인이 필요합니다.- 대기열에 쌓인 native port 메시지를 건너뛰는 로직, 그리고 유효하지 않은 manifest 값에 대한 JSON fallback도 함께 점검해야 합니다.