feat: Connect WebView traces with app traces by antonis · Pull Request #9474 · getsentry/sentry-cocoa

antonis · 2026-10-28T13:03:56Z

📜 Description

Stacked on #9487, which extracts the outgoing trace lookup from SentryNetworkTracker. #9488 adds the SentryObjC API on top.

Adds SentryWebViewTracing.addTracePropagation(to:options:), which connects the app's trace with web content in a WKWebView.

SentryWebViewTracing.addTracePropagation(
    to: webView,
    options: SentryWebViewTracingOptions(allowedHosts: ["app.example.com"])
)
webView.load(URLRequest(url: URL(string: "https://app.example.com")!))

Before any page script runs, the current trace is written into pages from the allowed hosts as sentry-trace and baggage meta tags, using a WKUserScript at document start. A @sentry/browser running in the page then continues the trace on pageload.

Accepts a WKWebView, WKWebViewConfiguration, WKUserContentController, or SwiftUI WebPage.Configuration (iOS 26+). The SentryObjC API follows in feat: Add SentryObjC WebView trace propagation #9488.
allowedHosts is a trust boundary, separate from tracePropagationTargets. A page matches an entry's host or its subdomains.
Only the main frame receives the trace, and sentry-transaction is removed from baggage.
Calling it again replaces Sentry's script with a fresh snapshot of the trace.
Each call records a WebViewTracePropagation integration for feature adoption.
The script and host normalization match sentry-react-native#6794 and sentry-java#6395. Unlike Android, any scheme is allowed, so pages served through custom scheme handlers (for example Capacitor's capacitor://localhost) work; App Transport Security already blocks plain http by default.

⚠️ Note for reviewing: I understand that this is a big PR since it also includes tests and the sample update I used for verification. I'll be happy to split those in a separate PR if it makes more sense 🙏

💡 Motivation and Context

resolves: Add support for WebViews #8897
resolves: Track WebView trace-connection feature adoption #9430

💚 How did you test it?

Added unit tests and tests that load a page in a real WKWebView and SwiftUI WebPage
Added UI tests and sample screens in the iOS-Swift test app (Extra → Web View, and its SwiftUI button on iOS 26)
Manually, with both screens running @sentry/browser on the iOS 26.5 simulator
Links to Sentry, WKWebView:
Links to Sentry, SwiftUI WebView:
- https://sentry-sdks.sentry.io/explore/traces/trace/7536d55d82e24fcc816766be349f33a5/
- https://sentry-sdks.sentry.io/explore/replays/c8fcafd398cd413d80bc971d0fd02316/ (replay)

📝 Checklist

I added GH Issue ID & Linear ID
I added tests to verify the changes.
No new PII added or SDK only sends newly added PII if sendDefaultPII is enabled.
I updated the docs if needed. (docs: Update Apple WebView guidance for connected traces #9136)
I updated the wizard if needed.
Review from the native team if needed.
No breaking change or entry added to the changelog.
No breaking change for hybrid SDKs or communicated to hybrid SDKs.

🔮 Next steps

Add SentryWebViewTracing.addTracePropagation(to:options:), which injects the current trace as sentry-trace and baggage meta tags into pages on allowed hosts before page scripts run, so @sentry/browser continues the trace on pageload. It accepts a WKUserContentController, WKWebViewConfiguration, WKWebView, or SwiftUI WebPage.Configuration (iOS 26+). SentryObjC exposes it as SentryObjCWebViewTracing. The injected script and host normalization match sentry-react-native and sentry-java. Using the API records the WebViewTracePropagation integration for adoption. Extract the outgoing trace lookup from the network tracker into SentryOutgoingTrace so both paths share it.

github-actions · 2026-10-28T13:04:29Z

	Messages
📖	Do not forget to update Sentry-docs with your feature once the pull request gets approved.

Generated by 🚫 dangerJS against 973db93

cursor

Stale Bugbot comment from a previous run.

…opagation

sentry · 2026-10-28T13:38:23Z

Size Analysis

1 component analyzed

iOS Builds

Name	Configuration	Version	Download Size	Install Size
SDK-Size (iOS) `io.sentry.sample.SDK-Size`	Release	9.32.0 (1)	1.2 MB (-580 B)	3.2 MB (0 B)

Configure sentry-cocoa status check rules

sentry · 2026-10-28T13:38:24Z

📲 Install Builds

iOS

🔗 App Name	App ID	Version	Configuration
SDK-Size	io.sentry.sample.SDK-Size	9.32.0 (1)	Release

⚙️ sentry-cocoa Build Distribution Settings

Run @sentry/browser in the iOS-Swift WebView screen so its pageload continues the app's trace, and add a SwiftUI WebPage screen on iOS 26. UI tests check that both pages see the injected trace before their own scripts run. Add a test that loads a page in a real WebPage created from a configuration with Sentry's script.

github-actions · 2026-10-29T09:41:01Z

🚨 Detected changes in high risk code 🚨

High-risk code can easily blow up and is hard to test. We had severe bugs in the past. Be extra careful when changing these files, and have an extra careful look at these:

Sources/Swift/Networking/SentryNetworkTracker.swift

Move SentryObjCWebViewTracing, its tests, and the SentryObjC API snapshots to a separate pull request stacked on this one, to keep this one focused on the Swift API.

cursor

✅ Bugbot reviewed your changes and found no new issues!

Comment @cursor review or bugbot run to trigger another review on this PR

^{Reviewed by Cursor Bugbot for commit 973db93. Configure here.}

itaybre

Almost LGTM, one small question

itaybre · 2026-10-30T20:15:16Z


    /// For testing purposes, we want to be able to change the DSN and store it to disk. In a real app, you shouldn't need this behavior.
-    var dsn: String? {
+    public var dsn: String? {


m: any reason to make this public?

itaybre · 2026-10-30T20:20:22Z

+        SentryWebViewTracePropagation.recordUsage(in: SentrySDK.isEnabled ? SentrySDKInternal.currentHub() : nil)
+        return SentryWebViewTracePropagation.install(
+            allowedHosts: options.allowedHosts,
+            on: userContentController,
+            hub: SentryWebViewTracePropagation.currentHub


m: Both SentrySDKInternal.currentHub() and SentryWebViewTracePropagation.currentHub should be the same Hub, right?
Would it be possible for the hub be passed as an argument?

antonis added 2 commits October 28, 2026 14:03

docs: Add pull request number to changelog

89789ca

antonis mentioned this pull request Oct 28, 2026

Automatic WebView trace propagation #9475

Open

cursor Bot reviewed Oct 28, 2026

View reviewed changes

Merge remote-tracking branch 'origin/main' into feat/webview-trace-pr…

4b27cbd

…opagation

antonis added the run-full-ci Allows gated GitHub Action workflows to run for a labelled pull request label Oct 28, 2026

antonis added 3 commits October 29, 2026 10:06

Merge branch 'main' into feat/webview-trace-propagation

e40c343

docs: Move changelog entry to Unreleased

44f0fc1

antonis mentioned this pull request Oct 29, 2026

ref: Extract outgoing trace lookup #9487

Open

4 tasks done

Merge branch 'ref/outgoing-trace' into feat/webview-trace-propagation

8f74f7c

antonis changed the base branch from main to ref/outgoing-trace October 29, 2026 10:03

ref: Split out the SentryObjC WebView API

973db93

Move SentryObjCWebViewTracing, its tests, and the SentryObjC API snapshots to a separate pull request stacked on this one, to keep this one focused on the Swift API.

antonis mentioned this pull request Oct 29, 2026

feat: Add SentryObjC WebView trace propagation #9488

Open

4 tasks done

cursor Bot reviewed Oct 29, 2026

View reviewed changes

antonis marked this pull request as ready for review October 29, 2026 12:33

antonis requested review from a team and noahsmartin as code owners October 29, 2026 12:33

antonis requested review from 0xadam-brown, itaybre, philprime and runningcode and removed request for a team October 29, 2026 12:33

antonis requested review from alwx and buenaflor and removed request for a team October 29, 2026 12:33

itaybre approved these changes Oct 30, 2026

View reviewed changes

github-actions Bot added the approved label Oct 30, 2026

Navigation Menu

Repository navigation

feat: Connect WebView traces with app traces - #9474

feat: Connect WebView traces with app traces#9474
antonis wants to merge 8 commits into
ref/outgoing-tracefrom
feat/webview-trace-propagation

antonis commented Oct 28, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Oct 28, 2026 •

edited

Loading

Uh oh!

cursor Bot left a comment •

edited

Loading

Uh oh!

sentry Bot commented Oct 28, 2026 •

edited

Loading

Uh oh!

sentry Bot commented Oct 28, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Oct 29, 2026 •

edited by antonis

Loading

Uh oh!

cursor Bot left a comment

Uh oh!

itaybre left a comment

Uh oh!

itaybre Oct 30, 2026

Uh oh!

itaybre Oct 30, 2026

Uh oh!

This branch has not been deployed

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

antonis commented Oct 28, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

📜 Description

💡 Motivation and Context

💚 How did you test it?

📝 Checklist

🔮 Next steps

Uh oh!

github-actions Bot commented Oct 28, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

cursor Bot left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

sentry Bot commented Oct 28, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Size Analysis

iOS Builds

Uh oh!

sentry Bot commented Oct 28, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

📲 Install Builds

iOS

Uh oh!

github-actions Bot commented Oct 29, 2026 • edited by antonis Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🚨 Detected changes in high risk code 🚨

Uh oh!

cursor Bot left a comment

Choose a reason for hiding this comment

Uh oh!

itaybre left a comment

Choose a reason for hiding this comment

Uh oh!

itaybre Oct 30, 2026

Choose a reason for hiding this comment

Uh oh!

itaybre Oct 30, 2026

Choose a reason for hiding this comment

Uh oh!

This branch has not been deployed

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

antonis commented Oct 28, 2026 •

edited

Loading

github-actions Bot commented Oct 28, 2026 •

edited

Loading

cursor Bot left a comment •

edited

Loading

sentry Bot commented Oct 28, 2026 •

edited

Loading

sentry Bot commented Oct 28, 2026 •

edited

Loading

github-actions Bot commented Oct 29, 2026 •

edited by antonis

Loading