← All reports

Support "message_serialization": "structured_clone" for extension messaging

Component: WebKit Web Extensions | e8d9b34

Source/WebKit/Shared/Extensions/WebExtensionContextParameters.serialization.in

double manifestVersion;
+ bool usesStructuredCloneMessageSerialization;

Source/WebKit/Shared/Extensions/WebExtensionContextParameters.h

double manifestVersion { 0 };
+ bool usesStructuredCloneMessageSerialization { false };

Source/WebKit/CMakeLists.txt

+ Shared/Extensions/WebExtensionMessage.serialization.in

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을 그대로 유지합니다.

이제 extension은 base64로 잘게 나눠 보내지 않고도 ArrayBuffer, Map, Date, Blob을 context 간에 전달할 수 있습니다. Blob 참조를 포함한 structured-clone payload가 새로운 IPC variant 타입을 통해 WebContent → UIProcess → WebContent 경로를 넘나들게 되었습니다.

새 variant 타입은 compromised sender가 도달할 수 있는 deserialization 경로이자 relay 경로입니다.