Files
moli/moli-renderer-v8/src/lib.rs
T
ldm0 b4982072f4 fix(script): checkpoint microtasks during event callback cleanup
Perform HTML script cleanup between event callbacks when the execution-context stack becomes empty, retaining currentTarget, passive state, and window.event through the checkpoint. Preserve script execution scopes during exception reporting, use the same callback boundary for Worker.onerror, and guard the complete microtask checkpoint against reentrancy.

Remove deferred window.event restoration. Update callback-order assertions and asynchronous fixtures to wait for the final event they inspect, while retaining scheduler, document-owner, and follow-up checks. Add Window, child Window, and Worker coverage for nested dispatch, listener removal in microtasks, and script versus callback exceptions.

Callback exception ordering follows Web IDL cleanup before rethrow; the local Chromium probe reports the error before that checkpoint.

WPT: 3 additional passes in the script-element microtask tests; the other 492 cases retain identical statuses and subtest results. Update the corresponding passed/failed case lists.

Validation: cargo fmt --all; cargo clippy --workspace --all-targets --all-features -- -D warnings; cargo nextest run --no-fail-fast (17,843 passed, 13 skipped). Fresh CLI build SHA-256 matches the binary used for the 495-case WPT comparison.
2026-11-02 06:01:32 +08:00

416 lines
19 KiB
Rust

//! V8-backed renderer implementation for Moli.
//!
//! This crate owns the JS/runtime machinery behind page execution: renderer
//! owner/page handles, the native bridge, script and module execution, Web API
//! bootstrap, and the renderer-side `ResourceRequestClient` wrapper used by the facade crate.
#![recursion_limit = "256"]
#[path = "planning.rs"]
mod script_planning;
mod stylesheet_blocking;
mod subresource_integrity;
pub use moli_dom as dom;
pub use moli_page_types as protocol_types;
pub use moli_parser as parser;
pub use moli_selector as selector;
pub use moli_v8_platform::ProcessEnvironmentOwner;
pub use app_manifest::{
RendererAppManifest, RendererAppManifestDisplayMode, RendererAppManifestError,
RendererAppManifestImageResource, RendererAppManifestLoadOutcome,
RendererAppManifestLoadPreparation, RendererAppManifestLoadPublication,
RendererAppManifestOrientation, RendererAppManifestProtocolHandler,
RendererAppManifestQueryResult, RendererAppManifestRelatedApplication,
RendererAppManifestShortcut, RendererPreparedAppManifestLoad,
};
mod abort_signal_route;
mod app_manifest;
mod blob;
mod broadcast_channel_runtime;
mod callback_invocation;
#[cfg(test)]
mod chromium_property_surface;
mod common_runtime;
mod content_security_policy;
mod context_bootstrap;
mod cross_origin_isolation;
mod css_custom_function;
mod css_resource_urls;
mod css_style;
mod custom_elements;
mod definitions;
mod detached_css_style;
mod detached_dom_surface;
mod detached_event_target;
mod devtools;
mod document_color_scheme;
mod document_cookie_owner;
mod document_language;
mod document_last_modified;
mod document_module_graph;
mod document_response_decoder;
mod document_runtime;
mod document_script_scheduler;
mod document_task_lane;
mod dom_parser;
mod dom_presentation;
mod dynamic_script_owner;
mod event_listener_args;
mod exception_reporting;
mod font_loading;
mod frame_owner_model;
mod host;
mod host_bindings;
mod inspector_microtasks;
mod inspector_session;
mod javascript_url;
mod layout_renderer;
mod link_as;
mod live_document_parser;
mod live_stylesheet;
pub(crate) mod local_executor;
mod message_port_runtime;
mod meta_refresh_scheduler;
mod module_runtime;
mod module_script_continuation;
mod modulepreload;
mod mutation_coordinator;
pub(crate) mod native_bridge;
pub mod network;
mod network_host;
mod observer_runtime;
mod opfs_owner_tasks;
mod opfs_task_result;
mod page_resource_completion;
mod page_task_queue;
mod parser_module_evaluation;
mod parser_module_pending;
mod parser_mutation_effects;
mod parser_script;
mod permissions_policy;
mod queue_microtask;
mod range_boundary;
mod referrer_policy;
mod render_runtime;
mod renderer_resource_scheduler;
mod resource_owner;
mod resource_ready;
mod runtime;
mod runtime_binding_data;
mod script_cleanup;
mod script_execution;
mod script_execution_control;
mod script_provenance;
mod script_vm;
mod scroll_options;
mod service_worker_runtime;
mod shared_worker_runtime;
mod structured_clone;
mod style_engine;
mod text_codec;
mod tokio_blocking_budget;
pub(crate) mod types;
mod util;
mod v8_execution_watchdog;
mod v8_finalizer;
pub(crate) mod v8_platform;
mod v8_traced_webidl_callback;
mod wasm_module_support;
mod web_storage_handles;
pub(crate) mod webidl;
mod webidl_callback_execution;
#[cfg(test)]
mod webidl_callback_source_boundary_tests;
mod webidl_iterator;
mod window_document_identity;
mod window_host;
mod window_webidl_callback;
pub(crate) mod worker;
mod worker_owner_wake;
mod xml_serializer;
pub(crate) mod planning {
pub(crate) use crate::script_planning::*;
}
#[cfg(test)]
pub(crate) fn ensure_v8_for_test() {
moli_v8_test_util::ensure_v8_with_flags_and_platform(
Some(v8_platform::initialization_flags()),
v8_platform::create_platform,
);
}
/// Real-layout policy for renderer fixtures whose assertions observe used
/// geometry or paint. Production defaults are configured outside test helpers.
#[cfg(test)]
pub(crate) const fn real_layout_test_policy() -> moli_page_types::LayoutPolicy {
moli_page_types::LayoutPolicy::OnDemand
}
/// Builds an owned HTML fixture through the same incremental parser frontier
/// used by executable Documents while retaining parser-time discovery output
/// needed by unit tests. This is deliberately test-only: production code must
/// keep the live parser session and deliver each handoff at its source boundary.
#[cfg(test)]
pub(crate) fn parse_html_test_fixture_with_parser_outputs(
final_url: url::Url,
html: String,
) -> (
dom::native::NativeDom,
Vec<parser::ParserScriptHandoff>,
Vec<DocumentOwnedBlockingStylesheetDiscoveryInput>,
) {
let stream = parser::HtmlParser::SCRIPTING_ENABLED.start_document(final_url);
stream.append_to_end(html);
let mut scripts = Vec::new();
let mut blocking_stylesheets = Vec::new();
while stream.has_pending_input() {
let outcome = stream.pump_next_parser_step(0);
blocking_stylesheets.extend(outcome.discovered_blocking_stylesheet_inputs);
if let parser::ParserPumpStep::Yield(parser::ParserYield::Script(script)) = outcome.result {
scripts.push(*script);
}
}
(stream.finish(), scripts, blocking_stylesheets)
}
#[allow(unused_imports)]
pub(crate) use crate::script_planning::{
ParserPlanningReadView, ParserScriptRead, PrepareScriptOutcome, PreparedScript,
build_prepared_script, classify_parser_script,
};
#[allow(unused_imports)]
pub(crate) use crate::stylesheet_blocking::{
DocumentBlockingStylesheetSignature, DocumentOwnedBlockingStylesheetDiscoveryInput,
StylesheetBlockingReadView, StylesheetElementRead,
collect_document_owned_blocking_stylesheet_discovery_inputs_before_in_view,
collect_document_owned_blocking_stylesheets_before_in_view,
};
pub use context_bootstrap::{
DEFAULT_ORIGIN_STORAGE_QUOTA_BYTES, IndexedDbKey, IndexedDbObjectStoreOptions,
IndexedDbTransactionMode, SharedIndexedDbManager, WeakIndexedDbManager,
clear_indexed_db_origin, clear_indexed_db_origins_with_prefix, downgrade_indexed_db_manager,
indexed_db_origin_usage_bytes, new_indexed_db_manager, new_sqlite_indexed_db_manager,
new_sqlite_indexed_db_manager_with_runtime,
};
pub use context_bootstrap::{
SharedStorageBucketStore, StorageBucketIdentity, new_shared_json_storage_bucket_store,
new_shared_json_storage_bucket_store_with_cache_root,
new_shared_json_storage_bucket_store_with_cache_root_and_indexed_db_manager,
new_shared_json_storage_bucket_store_with_storage_service, new_shared_storage_bucket_store,
new_shared_storage_bucket_store_with_indexed_db_manager,
new_shared_storage_bucket_store_with_storage_service,
new_shared_storage_bucket_store_with_storage_service_and_indexed_db_manager,
storage_bucket_indexed_db_storage_key,
};
pub use context_bootstrap::{
SharedWebStorageStore, WebStorageAreaKind, WebStorageMutation, WebStorageMutationRecord,
WebStorageMutationSubscription, WebStorageString, deep_clone_shared_web_storage_store,
new_shared_web_storage_store, web_storage_partitioned_area_key,
};
pub(crate) use context_bootstrap::{
construct_form_data_entries_for_form, form_data_entries_multipart_body,
form_data_entries_to_string_pairs, form_data_object_from_entries_for_window,
snapshot_form_data_value,
};
pub use document_cookie_owner::{
DocumentCookieBackendConnectionState, DocumentCookieBrowserContextSnapshot,
DocumentCookieGetFreshnessStatus, DocumentCookieOwnerSnapshot,
DocumentCookieSetReadinessStatus, DocumentCookieWriteCapabilitySnapshot,
};
pub use host::{
DocumentCookieCacheLookupResult, DocumentCookieCacheSnapshot, DocumentCookieCacheStatus,
DocumentCookieCapabilitySnapshot, DocumentCookieFacadeTelemetrySnapshot,
DocumentCookieFirstOperation,
};
pub use local_executor::is_on_js_local_executor;
pub use native_bridge::element::ClientRect as RendererClientRect;
pub use runtime::{
CompletedWorkerRuntimeInspectorCommandDispatch, DetachedParserScriptFetchContinuation,
DevToolsSessionKey, ExternalRawDocumentBodyStream, JsRuntime, JsRuntimeOwner, PageId,
PendingHtmlPage, PendingRendererPageReplacement, PendingWorkerRuntimeInspectorSessionResponse,
PreparedRendererDocument, RendererAccessibilityPayloadsForObjectId,
RendererActivityDiagnostics, RendererAgentAttachmentId, RendererAutofillAddressField,
RendererAutofillCreditCard, RendererAutofillTriggerOutcome, RendererAutofillTriggerRequest,
RendererAuxiliaryDocumentResponse, RendererAuxiliaryNavigationKind, RendererAuxiliaryWindow,
RendererBrowserContextRuntime, RendererBrowserContextRuntimeId,
RendererBrowserContextRuntimeOwner, RendererBrowserContextRuntimeOwnerAccess,
RendererBrowsingContextGroup, RendererBrowsingContextName, RendererCaptureScreencastFrameReply,
RendererCaptureScreencastFrameRequest, RendererCaptureScreenshotReply,
RendererCaptureScreenshotRequest, RendererCapturedDocumentEnvironment,
RendererCapturedScreencastFrame, RendererCapturedScreenshot, RendererCdpCall,
RendererCommandTurnCompletion, RendererCommandTurnOutput, RendererCountEntry,
RendererDedicatedWorkerTargetEvent, RendererDedicatedWorkerTargetInfo,
RendererDevToolsAgentToken, RendererDevToolsMainCommandEnvelope, RendererDocumentBoxModel,
RendererDocumentChildNodeSnapshotEvent, RendererDocumentChildNodeSnapshotEvents,
RendererDocumentChildNodeSnapshots, RendererDocumentCommandTarget,
RendererDocumentCommitPermit, RendererDocumentFrontendNodeIdsResolution,
RendererDocumentHitTestResult, RendererDocumentIsolateAccountingDiagnostics,
RendererDocumentLifecycleEvent, RendererDocumentLifecycleEventKind,
RendererDocumentLifecycleIdentity, RendererDocumentLifecycleMilestone,
RendererDocumentLifecycleSnapshot, RendererDocumentLifecycleWaitOutcome,
RendererDocumentLifecycleWaiter, RendererDocumentNodeAttributesResolution,
RendererDocumentNodeClientRect, RendererDocumentNodeGeometry,
RendererDocumentNodePropertyResolution, RendererDocumentNodeReference,
RendererDocumentNodeTextResolution, RendererDocumentOptions, RendererDocumentPreparationTarget,
RendererDocumentQuerySelectorNode, RendererDocumentQuerySelectorResolution,
RendererDocumentQuerySelectorWithChildNodeSnapshotEvents,
RendererDocumentSourcedSameDocumentNavigation,
RendererDocumentSourcedTopLevelLocationNavigation, RendererDocumentTerminationReason,
RendererDocumentTitleChanged, RendererDocumentToken, RendererDomAttributeMutation,
RendererDomAttributeMutationOutcome, RendererDomBidiNodeBindingResolution,
RendererDomBidiNodeSharedIdResolution, RendererDomDebuggerDomBreakpointResolution,
RendererDomDebuggerEventListener, RendererDomDebuggerEventListenerBreakpoint,
RendererDomDebuggerEventListenersResolution, RendererDomDebuggerXhrBreakpoint, RendererDomEdit,
RendererDomEditOutcome, RendererDomFocusOutcome, RendererDomFrontendNodeBindingResolution,
RendererDomMutationEvent, RendererDomMutationEventBatch, RendererDomNodeCreationStackFrame,
RendererDomNodeCreationStackTrace, RendererDomNodeReference,
RendererDomNodeStackTraceResolution, RendererDomSearchRegistration,
RendererDomSearchResultNode, RendererDomSearchResultsResolution,
RendererDomSnapshotCaptureOptions, RendererDomSnapshotCapturePayload, RendererDragData,
RendererDragDataItem, RendererDraggedDirectory, RendererDraggedFile, RendererFrameToken,
RendererGeometryQuad, RendererInputDispatchOutcome, RendererInspectorCommandEnvelope,
RendererInspectorCommandRoute, RendererInspectorIngressTicket,
RendererInspectorProtocolConfiguration, RendererInspectorProtocolConfigurationCommand,
RendererInspectorSessionRestoreSnapshot, RendererInterceptedDrag,
RendererJavaScriptDialogCompletion, RendererJavaScriptDialogId, RendererJavaScriptDialogResult,
RendererJavaScriptDialogSource, RendererLayoutMetrics, RendererLifecycleDecider,
RendererLifecycleDecision, RendererLifecycleEpoch, RendererLifecycleEventStamp,
RendererLifecycleSnapshot, RendererLifecycleStartReason, RendererLifecycleTerminationStamp,
RendererMainDocumentCommit, RendererMainDocumentResource, RendererMoliDomMemoryDiagnostics,
RendererMoliMemoryDiagnostics, RendererMoliMemoryScopeDiagnostics,
RendererMoliRuntimeMemoryDiagnostics, RendererNativeCommandReadyResponse,
RendererNativeCommandResponseGuard, RendererNativeCommandTerminal, RendererNativeOperation,
RendererNativeOperationStep, RendererNativeProtocolError, RendererNativeProtocolNotification,
RendererNativeProtocolResponse, RendererNativeProtocolStateUpdate, RendererNavigationInitiator,
RendererOutputCursor, RendererOutputFence, RendererOutputFenceLeaseId, RendererOutputItem,
RendererOutputPublication, RendererOutputPublicationOrdering, RendererOutputRecord,
RendererOutputResidenceIdentity, RendererOutputStreamCloseReason, RendererOutputStreamControl,
RendererOutputStreamEpoch, RendererOutputStreamIdentity, RendererOutputTransportDiagnostics,
RendererOutputTransportMessage, RendererOutputTransportReceiver,
RendererOutputTransportSendError, RendererOutputTransportSender, RendererOwnerAction,
RendererOwnerCommand, RendererOwnerHandle, RendererOwnerLocalHostId, RendererOwnerReply,
RendererOwnerResourceActivitySource, RendererOwnerRuntimeActivitySource,
RendererPageAccessError, RendererPageCommand, RendererPageCommandPending,
RendererPageCommandPostResponseContinuation, RendererPageCookieFacadeSnapshotReply,
RendererPageCreationArtifacts, RendererPageCreationDiagnostics, RendererPageCreationPhase,
RendererPageCreationProgress, RendererPageDiagnosticsSnapshot, RendererPageDumpFormat,
RendererPageDumpOptions, RendererPageDumpStripOptions, RendererPageHandle,
RendererPageReplacementCommit, RendererPageReplacementError,
RendererPageReplacementFailureDisposition, RendererPageReplacementReservationRequest,
RendererPageReplacementTarget, RendererPageReply, RendererPageReservationToken,
RendererPageState, RendererPageStateRevision, RendererPageTestingHandle, RendererPageView,
RendererPdfOptions, RendererPendingAuxiliaryPage, RendererPendingDownloadActivation,
RendererPendingDownloadResponse, RendererPendingFileChooserActivation,
RendererPendingJavaScriptDialog, RendererPendingPopupActivation,
RendererPendingSameDocumentNavigation, RendererPendingTopLevelHistoryTraversal,
RendererPendingWindowOpenEvent, RendererPerformanceMetricSnapshot,
RendererPointerEventProperties, RendererPopupActivationSource, RendererPopupDisposition,
RendererPreparedDocumentCommitConfiguration, RendererPrintToPdfReply,
RendererPrintToPdfRequest, RendererProtocolObservation, RendererReservedServiceWorkerClient,
RendererResourceContentBody, RendererResourceSearchRequest, RendererResourceTextSearchOutcome,
RendererRuntimeCommandCausalIdentity, RendererRuntimeCommandOutput,
RendererRuntimeEvaluationResult, RendererRuntimeHeapSpaceUsage, RendererRuntimeHeapUsage,
RendererRuntimeInspectorAsyncCompletion, RendererRuntimeInspectorIoCommandClaim,
RendererRuntimeInspectorIoCommandRoute, RendererRuntimeInspectorMainCommandCompletion,
RendererRuntimeInspectorMainCommandRoute, RendererRuntimeInspectorMessage,
RendererRuntimeInspectorMessageBatch, RendererRuntimeInspectorProtocolMessage,
RendererRuntimeInspectorProtocolMessageValueMut, RendererRuntimeInspectorResponseChannel,
RendererRuntimeInspectorResponseSender, RendererRuntimeObservableSourceItem,
RendererRuntimeObservableSourceSummary, RendererRuntimeRealmInfo, RendererRuntimeRemoteObject,
RendererRuntimeRemoteObjectResolution, RendererScreenshotClip, RendererScreenshotFormat,
RendererScreenshotRegion, RendererScriptExecutionMemoryDiagnostics,
RendererScriptSourceMemoryDiagnostics, RendererScrollIntoViewResult,
RendererServiceWorkerConsoleMessage, RendererServiceWorkerExceptionMessage,
RendererServiceWorkerFetchDiagnostic, RendererServiceWorkerFetchDiagnosticResult,
RendererServiceWorkerMainResourceFetch, RendererServiceWorkerRunIdentity,
RendererServiceWorkerTargetEvent, RendererServiceWorkerTargetInfo,
RendererServiceWorkerVersionStatus, RendererSetDocumentContentResult,
RendererSharedWorkerConsoleMessage, RendererSharedWorkerTargetEvent,
RendererSharedWorkerTargetInfo, RendererStyleSheetHeader, RendererStyleSheetInventoryUpdate,
RendererStyleSheetPayload, RendererSyntheticResponseBody, RendererTextSearchMatch,
RendererTouchPoint, RendererVisualStateToken, RendererWindowDocumentSource,
RuntimeConsoleMessageSnapshot, WorkerInspectorError, renderer_output_transport_channel,
};
pub use runtime::{
RendererElementClickError, RendererElementClickTarget, RendererPreparedPointerClick,
};
pub use runtime::{RendererPopupActivationParts, RendererRuntimeInspectorMessageResponseOrder};
pub use service_worker_runtime::{
SharedServiceWorkerResourceStore, new_shared_json_service_worker_resource_store,
new_shared_service_worker_resource_store,
};
pub use shared_worker_runtime::RendererSharedWorkerRuntimeDiagnostics;
pub(crate) use types::{
DocumentStartScript, PendingSubresourceContinueOutcome, SubresourceAuthCredentials,
SubresourceResourceType,
};
#[allow(unused_imports)]
pub use types::{ScriptKind, ScriptMode, ScriptRunOutcome, ScriptSourceKind};
pub use web_storage_handles::RendererWebStorageHandles;
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum PageVmInitStage {
DomContentLoaded,
Load,
}
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum RendererReplyBoundary {
/// Resolve page creation only after the requested lifecycle milestone.
Stage,
/// Publish the committed Document and continue DCL/load on owner turns.
DocumentCommit,
}
impl RendererReplyBoundary {
pub(crate) const fn waits_for_stage(self) -> bool {
matches!(self, Self::Stage)
}
}
/// Host integration route for cross-document top-level navigation requests.
///
/// This is not navigation ownership and is not Document lifecycle state. The
/// renderer always produces the request from the exact source Document. A
/// browser-managed page delegates that request to the browser navigation
/// controller; the standalone route is a compatibility adapter for renderer
/// APIs that do not yet have a browser controller.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum RendererTopLevelNavigationDispatch {
DelegateToBrowser,
FollowInStandaloneAdapter,
}
/// One-shot handling for a top-level navigation request observed while the
/// initial page-creation command is still waiting to reply.
///
/// Unlike [`RendererTopLevelNavigationDispatch`], this policy belongs only to
/// that command observer. It is discarded when the command replies or
/// detaches and never becomes stable Page or Document lifecycle state.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum RendererNavigationReplyPolicy {
FollowBeforeReply,
ReturnWithPendingNavigation,
}
impl RendererNavigationReplyPolicy {
pub(crate) const fn returns_with_pending_navigation(self) -> bool {
matches!(self, Self::ReturnWithPendingNavigation)
}
}
pub mod renderer {
pub use super::{
PageVmInitStage, RendererNavigationReplyPolicy, RendererReplyBoundary,
RendererTopLevelNavigationDispatch, is_on_js_local_executor,
};
}
mod web_api_interfaces;