#52720: docs: clarify initiator field can be parent or child frame in navigation events
Merged
Created: Aug 8, 2026, 8:27:53 PM
Merged: Aug 10, 2026, 6:30:44 PM
2 comments
Target: main
Description of Change
Closes #48793
Recreates #48915 (approved, but stalled on unsigned commits and an inactive PR) on top of latest main, preserving the original author's commit attribution.
- Documents that the
initiatorfield onwill-frame-navigate/will-navigate/did-start-navigation(and related navigation events) can also be a child frame — e.g. an unsandboxed iframe navigating its parent via<a target="_top">— not just a parent frame. Refs #48793.
Release Notes
Notes: none
Backports
Semver Impact
Major
Breaking changes
Minor
New features
Patch
Bug fixes
None
Docs, tests, etc.
Semantic Versioning helps users understand the impact of updates:
- Major (X.y.z): Breaking changes that may require code modifications
- Minor (x.Y.z): New features that maintain backward compatibility
- Patch (x.y.Z): Bug fixes that don't change the API
- None: Changes that don't affect using facing parts of Electron