feat(core): Extract text from children of touched components for breadcrumb labels

[antonis]

📢 Type of change

• Bugfix
• New feature
• Enhancement
• Refactoring

📜 Description

Walks the React fiber tree downward (child/sibling pointers) to extract text content from children of touched components. This text is used as a lowest-priority label fallback when no explicit label (sentry-label, custom labelKey) is set.

For example, a button like:

<TouchableOpacityonPress={save}><Text>Save workout</Text></TouchableOpacity>

will now produce a breadcrumb with label "Save workout" instead of just "TouchableOpacity".

Masking behavior

• When maskAllText is enabled (the default for replay users): text extraction is automatically disabled to avoid leaking masked content via breadcrumbs. No behavior change for these users.
• When maskAllText is explicitly false: text extraction is enabled.
• When MobileReplay integration is not installed: text extraction is enabled. This is a behavior change — users without replay will now see text labels in their touch breadcrumbs where previously they only saw component names. This can surface new data in breadcrumbs (component text content). Users can opt out via extractTextFromChildren: false on TouchEventBoundary.
• Per-view Sentry.Mask boundaries are respected: text inside <Sentry.Mask> is never extracted.

Safety limits

• Max text length: 64 characters (truncated with ...)
• Max depth: 3 levels of child traversal
• Max siblings: 5 per level (prevents runaway traversal in long lists)

New prop

extractTextFromChildren (default true) — set to false to opt out entirely.

Label priority (lowest to highest)

1. Extracted text children ← new
2. Custom labelKey prop value
3. sentry-label prop

💡 Motivation and Context

Touch breadcrumbs currently produce unhelpful labels like "Touch event within element: View" which makes Session Replay AI summaries and issue debugging less useful. This change automatically extracts meaningful labels from component text content.

Closes#6097

💚 How did you test it?

• 11 new unit tests covering: basic extraction, nested children, siblings, truncation, masking gate (maskAllText: true, false, undefined), Sentry.Mask boundary, priority over extracted text, extractTextFromChildren: false opt-out, raw text fiber nodes, integration without options
• All 31 touchevents tests pass
• Type check passes (no new TS errors)
• Lint passes (0 warnings, 0 errors)

📝 Checklist

• I added tests to verify changes
• No new PII added or SDK only sends newly added PII if sendDefaultPII is enabled
• I updated the docs if needed docs(react-native): Document text extraction from children for touch breadcrumbs sentry-docs#17665
• I updated the wizard if needed.
• All tests passing
• No breaking changes

🔮 Next steps

[github-actions]

Semver Impact of This PR

⚪ None (no version bump detected)

📋 Changelog Preview

This is how your changes will appear in the changelog.
Entries from this PR are highlighted with a left border (blockquote style).

---

• feat(core): Extract text from children of touched components for breadcrumb labels by antonis in #6106

• chore(deps): bump fast-uri from 3.0.1 to 3.1.2 by dependabot in #6121
• chore(deps): bump fast-xml-builder from 1.1.5 to 1.2.0 by dependabot in #6120
• chore(deps): bump socks to ^2.8.8 to fix ip-address vulnerability by antonis in #6117
• chore(deps): bump uuid to ^13.0.1 to fix buffer bounds check vulnerability by antonis in #6118
• test(replay): Add passthrough tests for device-state replay breadcrumbs by antonis in #6115
• chore(deps): update JavaScript SDK to v10.52.0 by github-actions in #6108
• chore(deps): bump basic-ftp from 5.3.0 to 5.3.1 by dependabot in #6111

---

_{🤖 This preview updates automatically when you update the PR.}

[github-actions]

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

Generated by 🚫 dangerJS against ae22e6c

[antonis]

@sentry review

[antonis]

@cursor review

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

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

[lucas-zimerman]

Would it be possible to add a depth limit & sibling limit test?

[antonis]

Would it be possible to add a depth limit & sibling limit test?

Good idea 👍 Added with 6fdacc4

[lucas-zimerman]

LGTM!

[sentry]

📲 Install Builds

Android

🔗 App Name	App ID	Version	Configuration
Sentry RN	io.sentry.reactnative.sample	8.11.0 (87)	Release

⚙️ sentry-react-native Build Distribution Settings

[github-actions]

iOS (legacy) Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	3838.73 ms	1216.71 ms	-2622.02 ms
Size	5.15 MiB	6.67 MiB	1.51 MiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
3817909+dirty	1183.90 ms	1187.50 ms	3.60 ms
23598c3+dirty	1207.00 ms	1209.90 ms	2.90 ms
890d145+dirty	1223.59 ms	1231.37 ms	7.78 ms
bc0d8cf+dirty	3830.33 ms	1220.52 ms	-2609.81 ms
8929511+dirty	1216.42 ms	1219.02 ms	2.60 ms
4b87b12+dirty	1212.90 ms	1222.09 ms	9.19 ms
7ac3378+dirty	1213.37 ms	1218.15 ms	4.78 ms
5c1e987+dirty	1204.30 ms	1222.15 ms	17.85 ms
5569641+dirty	3839.22 ms	1231.30 ms	-2607.91 ms
c004dae+dirty	3850.32 ms	1227.79 ms	-2622.53 ms

App size

Revision	Plain	With Sentry	Diff
3817909+dirty	3.38 MiB	4.73 MiB	1.35 MiB
23598c3+dirty	3.38 MiB	4.80 MiB	1.42 MiB
890d145+dirty	3.38 MiB	4.77 MiB	1.38 MiB
bc0d8cf+dirty	5.15 MiB	6.67 MiB	1.51 MiB
8929511+dirty	3.38 MiB	4.80 MiB	1.42 MiB
4b87b12+dirty	3.38 MiB	4.77 MiB	1.39 MiB
7ac3378+dirty	3.38 MiB	4.76 MiB	1.38 MiB
5c1e987+dirty	3.38 MiB	4.73 MiB	1.35 MiB
5569641+dirty	5.15 MiB	6.67 MiB	1.51 MiB
c004dae+dirty	5.15 MiB	6.67 MiB	1.51 MiB

[github-actions]

Android (legacy) Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	408.41 ms	445.86 ms	37.45 ms
Size	48.30 MiB	53.49 MiB	5.19 MiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
4953e94+dirty	442.02 ms	456.52 ms	14.50 ms
04207c4+dirty	459.19 ms	518.54 ms	59.35 ms
2c735cc+dirty	414.09 ms	438.47 ms	24.38 ms
44c8b3f+dirty	414.20 ms	457.28 ms	43.08 ms
d2eadf8+dirty	414.64 ms	454.56 ms	39.92 ms
c004dae+dirty	412.86 ms	481.50 ms	68.64 ms
ad66da3+dirty	468.46 ms	533.56 ms	65.10 ms
8929511+dirty	405.33 ms	452.16 ms	46.83 ms
100ce80+dirty	463.66 ms	539.56 ms	75.90 ms
df5d108+dirty	527.06 ms	603.58 ms	76.52 ms

App size

Revision	Plain	With Sentry	Diff
4953e94+dirty	43.75 MiB	48.08 MiB	4.33 MiB
04207c4+dirty	43.75 MiB	48.12 MiB	4.37 MiB
2c735cc+dirty	43.75 MiB	48.08 MiB	4.33 MiB
44c8b3f+dirty	48.30 MiB	53.46 MiB	5.15 MiB
d2eadf8+dirty	48.30 MiB	53.48 MiB	5.18 MiB
c004dae+dirty	48.30 MiB	53.49 MiB	5.19 MiB
ad66da3+dirty	48.30 MiB	53.49 MiB	5.19 MiB
8929511+dirty	43.75 MiB	48.16 MiB	4.41 MiB
100ce80+dirty	48.30 MiB	53.46 MiB	5.15 MiB
df5d108+dirty	43.75 MiB	48.08 MiB	4.33 MiB

[github-actions]

iOS (new) Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	3821.24 ms	1229.15 ms	-2592.09 ms
Size	5.15 MiB	6.67 MiB	1.51 MiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
3817909+dirty	1210.76 ms	1215.64 ms	4.89 ms
23598c3+dirty	1223.59 ms	1229.13 ms	5.53 ms
890d145+dirty	1212.98 ms	1220.10 ms	7.12 ms
bc0d8cf+dirty	3834.64 ms	1223.91 ms	-2610.73 ms
8929511+dirty	1223.41 ms	1222.49 ms	-0.92 ms
4b87b12+dirty	1199.49 ms	1199.78 ms	0.29 ms
7ac3378+dirty	1202.35 ms	1198.31 ms	-4.04 ms
5c1e987+dirty	1208.43 ms	1220.72 ms	12.29 ms
5569641+dirty	3824.35 ms	1210.78 ms	-2613.57 ms
c004dae+dirty	3857.82 ms	1224.87 ms	-2632.95 ms

App size

Revision	Plain	With Sentry	Diff
3817909+dirty	3.38 MiB	4.73 MiB	1.35 MiB
23598c3+dirty	3.38 MiB	4.80 MiB	1.42 MiB
890d145+dirty	3.38 MiB	4.77 MiB	1.38 MiB
bc0d8cf+dirty	5.15 MiB	6.67 MiB	1.51 MiB
8929511+dirty	3.38 MiB	4.80 MiB	1.42 MiB
4b87b12+dirty	3.38 MiB	4.77 MiB	1.39 MiB
7ac3378+dirty	3.38 MiB	4.76 MiB	1.38 MiB
5c1e987+dirty	3.38 MiB	4.73 MiB	1.35 MiB
5569641+dirty	5.15 MiB	6.67 MiB	1.51 MiB
c004dae+dirty	5.15 MiB	6.67 MiB	1.51 MiB

[github-actions]

Android (new) Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	405.50 ms	442.51 ms	37.01 ms
Size	48.30 MiB	53.49 MiB	5.19 MiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
8929511+dirty	469.49 ms	502.65 ms	33.16 ms
23598c3+dirty	371.92 ms	420.65 ms	48.74 ms
d2eadf8+dirty	468.02 ms	530.37 ms	62.35 ms
5c1e987+dirty	444.71 ms	475.13 ms	30.42 ms
c004dae+dirty	404.60 ms	430.67 ms	26.07 ms
ad66da3+dirty	411.49 ms	449.38 ms	37.89 ms
2c735cc+dirty	435.20 ms	459.48 ms	24.28 ms
7ac3378+dirty	410.67 ms	442.60 ms	31.92 ms
4953e94+dirty	398.80 ms	431.81 ms	33.01 ms
5fe1c6c+dirty	365.84 ms	408.62 ms	42.78 ms

App size

Revision	Plain	With Sentry	Diff
8929511+dirty	43.94 MiB	49.02 MiB	5.08 MiB
23598c3+dirty	43.94 MiB	49.02 MiB	5.08 MiB
d2eadf8+dirty	48.30 MiB	53.48 MiB	5.18 MiB
5c1e987+dirty	43.94 MiB	48.94 MiB	5.00 MiB
c004dae+dirty	48.30 MiB	53.49 MiB	5.19 MiB
ad66da3+dirty	48.30 MiB	53.49 MiB	5.19 MiB
2c735cc+dirty	43.94 MiB	48.94 MiB	5.00 MiB
7ac3378+dirty	43.94 MiB	48.99 MiB	5.05 MiB
4953e94+dirty	43.94 MiB	48.94 MiB	5.00 MiB
5fe1c6c+dirty	43.94 MiB	49.00 MiB	5.06 MiB

[antonis]

📢 Type of change

• Bugfix
• New feature
• Enhancement
• Refactoring

📜 Description

Walks the React fiber tree downward (child/sibling pointers) to extract text content from children of touched components. This text is used as a lowest-priority label fallback when no explicit label (sentry-label, custom labelKey) is set.

For example, a button like:

<TouchableOpacityonPress={save}><Text>Save workout</Text></TouchableOpacity>

will now produce a breadcrumb with label "Save workout" instead of just "TouchableOpacity".

Masking behavior

• When maskAllText is enabled (the default for replay users): text extraction is automatically disabled to avoid leaking masked content via breadcrumbs. No behavior change for these users.
• When maskAllText is explicitly false: text extraction is enabled.
• When MobileReplay integration is not installed: text extraction is enabled. This is a behavior change — users without replay will now see text labels in their touch breadcrumbs where previously they only saw component names. This can surface new data in breadcrumbs (component text content). Users can opt out via extractTextFromChildren: false on TouchEventBoundary.
• Per-view Sentry.Mask boundaries are respected: text inside <Sentry.Mask> is never extracted.

Safety limits

• Max text length: 64 characters (truncated with ...)
• Max depth: 3 levels of child traversal
• Max siblings: 5 per level (prevents runaway traversal in long lists)

New prop

extractTextFromChildren (default true) — set to false to opt out entirely.

Label priority (lowest to highest)

1. Extracted text children ← new
2. Custom labelKey prop value
3. sentry-label prop

💡 Motivation and Context

Touch breadcrumbs currently produce unhelpful labels like "Touch event within element: View" which makes Session Replay AI summaries and issue debugging less useful. This change automatically extracts meaningful labels from component text content.

Closes#6097

💚 How did you test it?

• 11 new unit tests covering: basic extraction, nested children, siblings, truncation, masking gate (maskAllText: true, false, undefined), Sentry.Mask boundary, priority over extracted text, extractTextFromChildren: false opt-out, raw text fiber nodes, integration without options
• All 31 touchevents tests pass
• Type check passes (no new TS errors)
• Lint passes (0 warnings, 0 errors)

📝 Checklist

• I added tests to verify changes
• No new PII added or SDK only sends newly added PII if sendDefaultPII is enabled
• I updated the docs if needed docs(react-native): Document text extraction from children for touch breadcrumbs sentry-docs#17665
• I updated the wizard if needed.
• All tests passing
• No breaking changes

🔮 Next steps

[github-actions]

Semver Impact of This PR

⚪ None (no version bump detected)

📋 Changelog Preview

This is how your changes will appear in the changelog.
Entries from this PR are highlighted with a left border (blockquote style).

---

• feat(core): Extract text from children of touched components for breadcrumb labels by antonis in #6106

• chore(deps): bump fast-uri from 3.0.1 to 3.1.2 by dependabot in #6121
• chore(deps): bump fast-xml-builder from 1.1.5 to 1.2.0 by dependabot in #6120
• chore(deps): bump socks to ^2.8.8 to fix ip-address vulnerability by antonis in #6117
• chore(deps): bump uuid to ^13.0.1 to fix buffer bounds check vulnerability by antonis in #6118
• test(replay): Add passthrough tests for device-state replay breadcrumbs by antonis in #6115
• chore(deps): update JavaScript SDK to v10.52.0 by github-actions in #6108
• chore(deps): bump basic-ftp from 5.3.0 to 5.3.1 by dependabot in #6111

---

_{🤖 This preview updates automatically when you update the PR.}

[github-actions]

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

Generated by 🚫 dangerJS against ae22e6c

[antonis]

@sentry review

[antonis]

@cursor review

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

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

[lucas-zimerman]

Would it be possible to add a depth limit & sibling limit test?

[antonis]

Would it be possible to add a depth limit & sibling limit test?

Good idea 👍 Added with 6fdacc4

[lucas-zimerman]

LGTM!

[sentry]

📲 Install Builds

Android

🔗 App Name	App ID	Version	Configuration
Sentry RN	io.sentry.reactnative.sample	8.11.0 (87)	Release

⚙️ sentry-react-native Build Distribution Settings

[github-actions]

iOS (legacy) Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	3838.73 ms	1216.71 ms	-2622.02 ms
Size	5.15 MiB	6.67 MiB	1.51 MiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
3817909+dirty	1183.90 ms	1187.50 ms	3.60 ms
23598c3+dirty	1207.00 ms	1209.90 ms	2.90 ms
890d145+dirty	1223.59 ms	1231.37 ms	7.78 ms
bc0d8cf+dirty	3830.33 ms	1220.52 ms	-2609.81 ms
8929511+dirty	1216.42 ms	1219.02 ms	2.60 ms
4b87b12+dirty	1212.90 ms	1222.09 ms	9.19 ms
7ac3378+dirty	1213.37 ms	1218.15 ms	4.78 ms
5c1e987+dirty	1204.30 ms	1222.15 ms	17.85 ms
5569641+dirty	3839.22 ms	1231.30 ms	-2607.91 ms
c004dae+dirty	3850.32 ms	1227.79 ms	-2622.53 ms

App size

Revision	Plain	With Sentry	Diff
3817909+dirty	3.38 MiB	4.73 MiB	1.35 MiB
23598c3+dirty	3.38 MiB	4.80 MiB	1.42 MiB
890d145+dirty	3.38 MiB	4.77 MiB	1.38 MiB
bc0d8cf+dirty	5.15 MiB	6.67 MiB	1.51 MiB
8929511+dirty	3.38 MiB	4.80 MiB	1.42 MiB
4b87b12+dirty	3.38 MiB	4.77 MiB	1.39 MiB
7ac3378+dirty	3.38 MiB	4.76 MiB	1.38 MiB
5c1e987+dirty	3.38 MiB	4.73 MiB	1.35 MiB
5569641+dirty	5.15 MiB	6.67 MiB	1.51 MiB
c004dae+dirty	5.15 MiB	6.67 MiB	1.51 MiB

[github-actions]

Android (legacy) Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	408.41 ms	445.86 ms	37.45 ms
Size	48.30 MiB	53.49 MiB	5.19 MiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
4953e94+dirty	442.02 ms	456.52 ms	14.50 ms
04207c4+dirty	459.19 ms	518.54 ms	59.35 ms
2c735cc+dirty	414.09 ms	438.47 ms	24.38 ms
44c8b3f+dirty	414.20 ms	457.28 ms	43.08 ms
d2eadf8+dirty	414.64 ms	454.56 ms	39.92 ms
c004dae+dirty	412.86 ms	481.50 ms	68.64 ms
ad66da3+dirty	468.46 ms	533.56 ms	65.10 ms
8929511+dirty	405.33 ms	452.16 ms	46.83 ms
100ce80+dirty	463.66 ms	539.56 ms	75.90 ms
df5d108+dirty	527.06 ms	603.58 ms	76.52 ms

App size

Revision	Plain	With Sentry	Diff
4953e94+dirty	43.75 MiB	48.08 MiB	4.33 MiB
04207c4+dirty	43.75 MiB	48.12 MiB	4.37 MiB
2c735cc+dirty	43.75 MiB	48.08 MiB	4.33 MiB
44c8b3f+dirty	48.30 MiB	53.46 MiB	5.15 MiB
d2eadf8+dirty	48.30 MiB	53.48 MiB	5.18 MiB
c004dae+dirty	48.30 MiB	53.49 MiB	5.19 MiB
ad66da3+dirty	48.30 MiB	53.49 MiB	5.19 MiB
8929511+dirty	43.75 MiB	48.16 MiB	4.41 MiB
100ce80+dirty	48.30 MiB	53.46 MiB	5.15 MiB
df5d108+dirty	43.75 MiB	48.08 MiB	4.33 MiB

[github-actions]

iOS (new) Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	3821.24 ms	1229.15 ms	-2592.09 ms
Size	5.15 MiB	6.67 MiB	1.51 MiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
3817909+dirty	1210.76 ms	1215.64 ms	4.89 ms
23598c3+dirty	1223.59 ms	1229.13 ms	5.53 ms
890d145+dirty	1212.98 ms	1220.10 ms	7.12 ms
bc0d8cf+dirty	3834.64 ms	1223.91 ms	-2610.73 ms
8929511+dirty	1223.41 ms	1222.49 ms	-0.92 ms
4b87b12+dirty	1199.49 ms	1199.78 ms	0.29 ms
7ac3378+dirty	1202.35 ms	1198.31 ms	-4.04 ms
5c1e987+dirty	1208.43 ms	1220.72 ms	12.29 ms
5569641+dirty	3824.35 ms	1210.78 ms	-2613.57 ms
c004dae+dirty	3857.82 ms	1224.87 ms	-2632.95 ms

App size

Revision	Plain	With Sentry	Diff
3817909+dirty	3.38 MiB	4.73 MiB	1.35 MiB
23598c3+dirty	3.38 MiB	4.80 MiB	1.42 MiB
890d145+dirty	3.38 MiB	4.77 MiB	1.38 MiB
bc0d8cf+dirty	5.15 MiB	6.67 MiB	1.51 MiB
8929511+dirty	3.38 MiB	4.80 MiB	1.42 MiB
4b87b12+dirty	3.38 MiB	4.77 MiB	1.39 MiB
7ac3378+dirty	3.38 MiB	4.76 MiB	1.38 MiB
5c1e987+dirty	3.38 MiB	4.73 MiB	1.35 MiB
5569641+dirty	5.15 MiB	6.67 MiB	1.51 MiB
c004dae+dirty	5.15 MiB	6.67 MiB	1.51 MiB

[github-actions]

Android (new) Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	405.50 ms	442.51 ms	37.01 ms
Size	48.30 MiB	53.49 MiB	5.19 MiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
8929511+dirty	469.49 ms	502.65 ms	33.16 ms
23598c3+dirty	371.92 ms	420.65 ms	48.74 ms
d2eadf8+dirty	468.02 ms	530.37 ms	62.35 ms
5c1e987+dirty	444.71 ms	475.13 ms	30.42 ms
c004dae+dirty	404.60 ms	430.67 ms	26.07 ms
ad66da3+dirty	411.49 ms	449.38 ms	37.89 ms
2c735cc+dirty	435.20 ms	459.48 ms	24.28 ms
7ac3378+dirty	410.67 ms	442.60 ms	31.92 ms
4953e94+dirty	398.80 ms	431.81 ms	33.01 ms
5fe1c6c+dirty	365.84 ms	408.62 ms	42.78 ms

App size

Revision	Plain	With Sentry	Diff
8929511+dirty	43.94 MiB	49.02 MiB	5.08 MiB
23598c3+dirty	43.94 MiB	49.02 MiB	5.08 MiB
d2eadf8+dirty	48.30 MiB	53.48 MiB	5.18 MiB
5c1e987+dirty	43.94 MiB	48.94 MiB	5.00 MiB
c004dae+dirty	48.30 MiB	53.49 MiB	5.19 MiB
ad66da3+dirty	48.30 MiB	53.49 MiB	5.19 MiB
2c735cc+dirty	43.94 MiB	48.94 MiB	5.00 MiB
7ac3378+dirty	43.94 MiB	48.99 MiB	5.05 MiB
4953e94+dirty	43.94 MiB	48.94 MiB	5.00 MiB
5fe1c6c+dirty	43.94 MiB	49.00 MiB	5.06 MiB

[antonis]

📢 Type of change

• Bugfix
• New feature
• Enhancement
• Refactoring

📜 Description

Walks the React fiber tree downward (child/sibling pointers) to extract text content from children of touched components. This text is used as a lowest-priority label fallback when no explicit label (sentry-label, custom labelKey) is set.

For example, a button like:

<TouchableOpacityonPress={save}><Text>Save workout</Text></TouchableOpacity>

will now produce a breadcrumb with label "Save workout" instead of just "TouchableOpacity".

Masking behavior

• When maskAllText is enabled (the default for replay users): text extraction is automatically disabled to avoid leaking masked content via breadcrumbs. No behavior change for these users.
• When maskAllText is explicitly false: text extraction is enabled.
• When MobileReplay integration is not installed: text extraction is enabled. This is a behavior change — users without replay will now see text labels in their touch breadcrumbs where previously they only saw component names. This can surface new data in breadcrumbs (component text content). Users can opt out via extractTextFromChildren: false on TouchEventBoundary.
• Per-view Sentry.Mask boundaries are respected: text inside <Sentry.Mask> is never extracted.

Safety limits

• Max text length: 64 characters (truncated with ...)
• Max depth: 3 levels of child traversal
• Max siblings: 5 per level (prevents runaway traversal in long lists)

New prop

extractTextFromChildren (default true) — set to false to opt out entirely.

Label priority (lowest to highest)

1. Extracted text children ← new
2. Custom labelKey prop value
3. sentry-label prop

💡 Motivation and Context

Touch breadcrumbs currently produce unhelpful labels like "Touch event within element: View" which makes Session Replay AI summaries and issue debugging less useful. This change automatically extracts meaningful labels from component text content.

Closes#6097

💚 How did you test it?

• 11 new unit tests covering: basic extraction, nested children, siblings, truncation, masking gate (maskAllText: true, false, undefined), Sentry.Mask boundary, priority over extracted text, extractTextFromChildren: false opt-out, raw text fiber nodes, integration without options
• All 31 touchevents tests pass
• Type check passes (no new TS errors)
• Lint passes (0 warnings, 0 errors)

📝 Checklist

• I added tests to verify changes
• No new PII added or SDK only sends newly added PII if sendDefaultPII is enabled
• I updated the docs if needed docs(react-native): Document text extraction from children for touch breadcrumbs sentry-docs#17665
• I updated the wizard if needed.
• All tests passing
• No breaking changes

🔮 Next steps

[github-actions]

Semver Impact of This PR

⚪ None (no version bump detected)

📋 Changelog Preview

This is how your changes will appear in the changelog.
Entries from this PR are highlighted with a left border (blockquote style).

---

• feat(core): Extract text from children of touched components for breadcrumb labels by antonis in #6106

• chore(deps): bump fast-uri from 3.0.1 to 3.1.2 by dependabot in #6121
• chore(deps): bump fast-xml-builder from 1.1.5 to 1.2.0 by dependabot in #6120
• chore(deps): bump socks to ^2.8.8 to fix ip-address vulnerability by antonis in #6117
• chore(deps): bump uuid to ^13.0.1 to fix buffer bounds check vulnerability by antonis in #6118
• test(replay): Add passthrough tests for device-state replay breadcrumbs by antonis in #6115
• chore(deps): update JavaScript SDK to v10.52.0 by github-actions in #6108
• chore(deps): bump basic-ftp from 5.3.0 to 5.3.1 by dependabot in #6111

---

_{🤖 This preview updates automatically when you update the PR.}

[github-actions]

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

Generated by 🚫 dangerJS against ae22e6c

[antonis]

@sentry review

[antonis]

@cursor review

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

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

[lucas-zimerman]

Would it be possible to add a depth limit & sibling limit test?

[antonis]

Would it be possible to add a depth limit & sibling limit test?

Good idea 👍 Added with 6fdacc4

[lucas-zimerman]

LGTM!

[sentry]

📲 Install Builds

Android

🔗 App Name	App ID	Version	Configuration
Sentry RN	io.sentry.reactnative.sample	8.11.0 (87)	Release

⚙️ sentry-react-native Build Distribution Settings

[github-actions]

iOS (legacy) Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	3838.73 ms	1216.71 ms	-2622.02 ms
Size	5.15 MiB	6.67 MiB	1.51 MiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
3817909+dirty	1183.90 ms	1187.50 ms	3.60 ms
23598c3+dirty	1207.00 ms	1209.90 ms	2.90 ms
890d145+dirty	1223.59 ms	1231.37 ms	7.78 ms
bc0d8cf+dirty	3830.33 ms	1220.52 ms	-2609.81 ms
8929511+dirty	1216.42 ms	1219.02 ms	2.60 ms
4b87b12+dirty	1212.90 ms	1222.09 ms	9.19 ms
7ac3378+dirty	1213.37 ms	1218.15 ms	4.78 ms
5c1e987+dirty	1204.30 ms	1222.15 ms	17.85 ms
5569641+dirty	3839.22 ms	1231.30 ms	-2607.91 ms
c004dae+dirty	3850.32 ms	1227.79 ms	-2622.53 ms

App size

Revision	Plain	With Sentry	Diff
3817909+dirty	3.38 MiB	4.73 MiB	1.35 MiB
23598c3+dirty	3.38 MiB	4.80 MiB	1.42 MiB
890d145+dirty	3.38 MiB	4.77 MiB	1.38 MiB
bc0d8cf+dirty	5.15 MiB	6.67 MiB	1.51 MiB
8929511+dirty	3.38 MiB	4.80 MiB	1.42 MiB
4b87b12+dirty	3.38 MiB	4.77 MiB	1.39 MiB
7ac3378+dirty	3.38 MiB	4.76 MiB	1.38 MiB
5c1e987+dirty	3.38 MiB	4.73 MiB	1.35 MiB
5569641+dirty	5.15 MiB	6.67 MiB	1.51 MiB
c004dae+dirty	5.15 MiB	6.67 MiB	1.51 MiB

[github-actions]

Android (legacy) Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	408.41 ms	445.86 ms	37.45 ms
Size	48.30 MiB	53.49 MiB	5.19 MiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
4953e94+dirty	442.02 ms	456.52 ms	14.50 ms
04207c4+dirty	459.19 ms	518.54 ms	59.35 ms
2c735cc+dirty	414.09 ms	438.47 ms	24.38 ms
44c8b3f+dirty	414.20 ms	457.28 ms	43.08 ms
d2eadf8+dirty	414.64 ms	454.56 ms	39.92 ms
c004dae+dirty	412.86 ms	481.50 ms	68.64 ms
ad66da3+dirty	468.46 ms	533.56 ms	65.10 ms
8929511+dirty	405.33 ms	452.16 ms	46.83 ms
100ce80+dirty	463.66 ms	539.56 ms	75.90 ms
df5d108+dirty	527.06 ms	603.58 ms	76.52 ms

App size

Revision	Plain	With Sentry	Diff
4953e94+dirty	43.75 MiB	48.08 MiB	4.33 MiB
04207c4+dirty	43.75 MiB	48.12 MiB	4.37 MiB
2c735cc+dirty	43.75 MiB	48.08 MiB	4.33 MiB
44c8b3f+dirty	48.30 MiB	53.46 MiB	5.15 MiB
d2eadf8+dirty	48.30 MiB	53.48 MiB	5.18 MiB
c004dae+dirty	48.30 MiB	53.49 MiB	5.19 MiB
ad66da3+dirty	48.30 MiB	53.49 MiB	5.19 MiB
8929511+dirty	43.75 MiB	48.16 MiB	4.41 MiB
100ce80+dirty	48.30 MiB	53.46 MiB	5.15 MiB
df5d108+dirty	43.75 MiB	48.08 MiB	4.33 MiB

[github-actions]

iOS (new) Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	3821.24 ms	1229.15 ms	-2592.09 ms
Size	5.15 MiB	6.67 MiB	1.51 MiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
3817909+dirty	1210.76 ms	1215.64 ms	4.89 ms
23598c3+dirty	1223.59 ms	1229.13 ms	5.53 ms
890d145+dirty	1212.98 ms	1220.10 ms	7.12 ms
bc0d8cf+dirty	3834.64 ms	1223.91 ms	-2610.73 ms
8929511+dirty	1223.41 ms	1222.49 ms	-0.92 ms
4b87b12+dirty	1199.49 ms	1199.78 ms	0.29 ms
7ac3378+dirty	1202.35 ms	1198.31 ms	-4.04 ms
5c1e987+dirty	1208.43 ms	1220.72 ms	12.29 ms
5569641+dirty	3824.35 ms	1210.78 ms	-2613.57 ms
c004dae+dirty	3857.82 ms	1224.87 ms	-2632.95 ms

App size

Revision	Plain	With Sentry	Diff
3817909+dirty	3.38 MiB	4.73 MiB	1.35 MiB
23598c3+dirty	3.38 MiB	4.80 MiB	1.42 MiB
890d145+dirty	3.38 MiB	4.77 MiB	1.38 MiB
bc0d8cf+dirty	5.15 MiB	6.67 MiB	1.51 MiB
8929511+dirty	3.38 MiB	4.80 MiB	1.42 MiB
4b87b12+dirty	3.38 MiB	4.77 MiB	1.39 MiB
7ac3378+dirty	3.38 MiB	4.76 MiB	1.38 MiB
5c1e987+dirty	3.38 MiB	4.73 MiB	1.35 MiB
5569641+dirty	5.15 MiB	6.67 MiB	1.51 MiB
c004dae+dirty	5.15 MiB	6.67 MiB	1.51 MiB

[github-actions]

Android (new) Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	405.50 ms	442.51 ms	37.01 ms
Size	48.30 MiB	53.49 MiB	5.19 MiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
8929511+dirty	469.49 ms	502.65 ms	33.16 ms
23598c3+dirty	371.92 ms	420.65 ms	48.74 ms
d2eadf8+dirty	468.02 ms	530.37 ms	62.35 ms
5c1e987+dirty	444.71 ms	475.13 ms	30.42 ms
c004dae+dirty	404.60 ms	430.67 ms	26.07 ms
ad66da3+dirty	411.49 ms	449.38 ms	37.89 ms
2c735cc+dirty	435.20 ms	459.48 ms	24.28 ms
7ac3378+dirty	410.67 ms	442.60 ms	31.92 ms
4953e94+dirty	398.80 ms	431.81 ms	33.01 ms
5fe1c6c+dirty	365.84 ms	408.62 ms	42.78 ms

App size

Revision	Plain	With Sentry	Diff
8929511+dirty	43.94 MiB	49.02 MiB	5.08 MiB
23598c3+dirty	43.94 MiB	49.02 MiB	5.08 MiB
d2eadf8+dirty	48.30 MiB	53.48 MiB	5.18 MiB
5c1e987+dirty	43.94 MiB	48.94 MiB	5.00 MiB
c004dae+dirty	48.30 MiB	53.49 MiB	5.19 MiB
ad66da3+dirty	48.30 MiB	53.49 MiB	5.19 MiB
2c735cc+dirty	43.94 MiB	48.94 MiB	5.00 MiB
7ac3378+dirty	43.94 MiB	48.99 MiB	5.05 MiB
4953e94+dirty	43.94 MiB	48.94 MiB	5.00 MiB
5fe1c6c+dirty	43.94 MiB	49.00 MiB	5.06 MiB

[antonis]

📢 Type of change

• Bugfix
• New feature
• Enhancement
• Refactoring

📜 Description

Walks the React fiber tree downward (child/sibling pointers) to extract text content from children of touched components. This text is used as a lowest-priority label fallback when no explicit label (sentry-label, custom labelKey) is set.

For example, a button like:

<TouchableOpacityonPress={save}><Text>Save workout</Text></TouchableOpacity>

will now produce a breadcrumb with label "Save workout" instead of just "TouchableOpacity".

Masking behavior

• When maskAllText is enabled (the default for replay users): text extraction is automatically disabled to avoid leaking masked content via breadcrumbs. No behavior change for these users.
• When maskAllText is explicitly false: text extraction is enabled.
• When MobileReplay integration is not installed: text extraction is enabled. This is a behavior change — users without replay will now see text labels in their touch breadcrumbs where previously they only saw component names. This can surface new data in breadcrumbs (component text content). Users can opt out via extractTextFromChildren: false on TouchEventBoundary.
• Per-view Sentry.Mask boundaries are respected: text inside <Sentry.Mask> is never extracted.

Safety limits

• Max text length: 64 characters (truncated with ...)
• Max depth: 3 levels of child traversal
• Max siblings: 5 per level (prevents runaway traversal in long lists)

New prop

extractTextFromChildren (default true) — set to false to opt out entirely.

Label priority (lowest to highest)

1. Extracted text children ← new
2. Custom labelKey prop value
3. sentry-label prop

💡 Motivation and Context

Touch breadcrumbs currently produce unhelpful labels like "Touch event within element: View" which makes Session Replay AI summaries and issue debugging less useful. This change automatically extracts meaningful labels from component text content.

Closes#6097

💚 How did you test it?

• 11 new unit tests covering: basic extraction, nested children, siblings, truncation, masking gate (maskAllText: true, false, undefined), Sentry.Mask boundary, priority over extracted text, extractTextFromChildren: false opt-out, raw text fiber nodes, integration without options
• All 31 touchevents tests pass
• Type check passes (no new TS errors)
• Lint passes (0 warnings, 0 errors)

📝 Checklist

• I added tests to verify changes
• No new PII added or SDK only sends newly added PII if sendDefaultPII is enabled
• I updated the docs if needed docs(react-native): Document text extraction from children for touch breadcrumbs sentry-docs#17665
• I updated the wizard if needed.
• All tests passing
• No breaking changes

🔮 Next steps

[github-actions]

Semver Impact of This PR

⚪ None (no version bump detected)

📋 Changelog Preview

This is how your changes will appear in the changelog.
Entries from this PR are highlighted with a left border (blockquote style).

---

• feat(core): Extract text from children of touched components for breadcrumb labels by antonis in #6106

• chore(deps): bump fast-uri from 3.0.1 to 3.1.2 by dependabot in #6121
• chore(deps): bump fast-xml-builder from 1.1.5 to 1.2.0 by dependabot in #6120
• chore(deps): bump socks to ^2.8.8 to fix ip-address vulnerability by antonis in #6117
• chore(deps): bump uuid to ^13.0.1 to fix buffer bounds check vulnerability by antonis in #6118
• test(replay): Add passthrough tests for device-state replay breadcrumbs by antonis in #6115
• chore(deps): update JavaScript SDK to v10.52.0 by github-actions in #6108
• chore(deps): bump basic-ftp from 5.3.0 to 5.3.1 by dependabot in #6111

---

_{🤖 This preview updates automatically when you update the PR.}

[github-actions]

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

Generated by 🚫 dangerJS against ae22e6c

[antonis]

@sentry review

[antonis]

@cursor review

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

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

[lucas-zimerman]

Would it be possible to add a depth limit & sibling limit test?

[antonis]

Would it be possible to add a depth limit & sibling limit test?

Good idea 👍 Added with 6fdacc4

[lucas-zimerman]

LGTM!

[sentry]

📲 Install Builds

Android

🔗 App Name	App ID	Version	Configuration
Sentry RN	io.sentry.reactnative.sample	8.11.0 (87)	Release

⚙️ sentry-react-native Build Distribution Settings

[github-actions]

iOS (legacy) Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	3838.73 ms	1216.71 ms	-2622.02 ms
Size	5.15 MiB	6.67 MiB	1.51 MiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
3817909+dirty	1183.90 ms	1187.50 ms	3.60 ms
23598c3+dirty	1207.00 ms	1209.90 ms	2.90 ms
890d145+dirty	1223.59 ms	1231.37 ms	7.78 ms
bc0d8cf+dirty	3830.33 ms	1220.52 ms	-2609.81 ms
8929511+dirty	1216.42 ms	1219.02 ms	2.60 ms
4b87b12+dirty	1212.90 ms	1222.09 ms	9.19 ms
7ac3378+dirty	1213.37 ms	1218.15 ms	4.78 ms
5c1e987+dirty	1204.30 ms	1222.15 ms	17.85 ms
5569641+dirty	3839.22 ms	1231.30 ms	-2607.91 ms
c004dae+dirty	3850.32 ms	1227.79 ms	-2622.53 ms

App size

Revision	Plain	With Sentry	Diff
3817909+dirty	3.38 MiB	4.73 MiB	1.35 MiB
23598c3+dirty	3.38 MiB	4.80 MiB	1.42 MiB
890d145+dirty	3.38 MiB	4.77 MiB	1.38 MiB
bc0d8cf+dirty	5.15 MiB	6.67 MiB	1.51 MiB
8929511+dirty	3.38 MiB	4.80 MiB	1.42 MiB
4b87b12+dirty	3.38 MiB	4.77 MiB	1.39 MiB
7ac3378+dirty	3.38 MiB	4.76 MiB	1.38 MiB
5c1e987+dirty	3.38 MiB	4.73 MiB	1.35 MiB
5569641+dirty	5.15 MiB	6.67 MiB	1.51 MiB
c004dae+dirty	5.15 MiB	6.67 MiB	1.51 MiB

[github-actions]

Android (legacy) Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	408.41 ms	445.86 ms	37.45 ms
Size	48.30 MiB	53.49 MiB	5.19 MiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
4953e94+dirty	442.02 ms	456.52 ms	14.50 ms
04207c4+dirty	459.19 ms	518.54 ms	59.35 ms
2c735cc+dirty	414.09 ms	438.47 ms	24.38 ms
44c8b3f+dirty	414.20 ms	457.28 ms	43.08 ms
d2eadf8+dirty	414.64 ms	454.56 ms	39.92 ms
c004dae+dirty	412.86 ms	481.50 ms	68.64 ms
ad66da3+dirty	468.46 ms	533.56 ms	65.10 ms
8929511+dirty	405.33 ms	452.16 ms	46.83 ms
100ce80+dirty	463.66 ms	539.56 ms	75.90 ms
df5d108+dirty	527.06 ms	603.58 ms	76.52 ms

App size

Revision	Plain	With Sentry	Diff
4953e94+dirty	43.75 MiB	48.08 MiB	4.33 MiB
04207c4+dirty	43.75 MiB	48.12 MiB	4.37 MiB
2c735cc+dirty	43.75 MiB	48.08 MiB	4.33 MiB
44c8b3f+dirty	48.30 MiB	53.46 MiB	5.15 MiB
d2eadf8+dirty	48.30 MiB	53.48 MiB	5.18 MiB
c004dae+dirty	48.30 MiB	53.49 MiB	5.19 MiB
ad66da3+dirty	48.30 MiB	53.49 MiB	5.19 MiB
8929511+dirty	43.75 MiB	48.16 MiB	4.41 MiB
100ce80+dirty	48.30 MiB	53.46 MiB	5.15 MiB
df5d108+dirty	43.75 MiB	48.08 MiB	4.33 MiB

[github-actions]

iOS (new) Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	3821.24 ms	1229.15 ms	-2592.09 ms
Size	5.15 MiB	6.67 MiB	1.51 MiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
3817909+dirty	1210.76 ms	1215.64 ms	4.89 ms
23598c3+dirty	1223.59 ms	1229.13 ms	5.53 ms
890d145+dirty	1212.98 ms	1220.10 ms	7.12 ms
bc0d8cf+dirty	3834.64 ms	1223.91 ms	-2610.73 ms
8929511+dirty	1223.41 ms	1222.49 ms	-0.92 ms
4b87b12+dirty	1199.49 ms	1199.78 ms	0.29 ms
7ac3378+dirty	1202.35 ms	1198.31 ms	-4.04 ms
5c1e987+dirty	1208.43 ms	1220.72 ms	12.29 ms
5569641+dirty	3824.35 ms	1210.78 ms	-2613.57 ms
c004dae+dirty	3857.82 ms	1224.87 ms	-2632.95 ms

App size

Revision	Plain	With Sentry	Diff
3817909+dirty	3.38 MiB	4.73 MiB	1.35 MiB
23598c3+dirty	3.38 MiB	4.80 MiB	1.42 MiB
890d145+dirty	3.38 MiB	4.77 MiB	1.38 MiB
bc0d8cf+dirty	5.15 MiB	6.67 MiB	1.51 MiB
8929511+dirty	3.38 MiB	4.80 MiB	1.42 MiB
4b87b12+dirty	3.38 MiB	4.77 MiB	1.39 MiB
7ac3378+dirty	3.38 MiB	4.76 MiB	1.38 MiB
5c1e987+dirty	3.38 MiB	4.73 MiB	1.35 MiB
5569641+dirty	5.15 MiB	6.67 MiB	1.51 MiB
c004dae+dirty	5.15 MiB	6.67 MiB	1.51 MiB

[github-actions]

Android (new) Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	405.50 ms	442.51 ms	37.01 ms
Size	48.30 MiB	53.49 MiB	5.19 MiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
8929511+dirty	469.49 ms	502.65 ms	33.16 ms
23598c3+dirty	371.92 ms	420.65 ms	48.74 ms
d2eadf8+dirty	468.02 ms	530.37 ms	62.35 ms
5c1e987+dirty	444.71 ms	475.13 ms	30.42 ms
c004dae+dirty	404.60 ms	430.67 ms	26.07 ms
ad66da3+dirty	411.49 ms	449.38 ms	37.89 ms
2c735cc+dirty	435.20 ms	459.48 ms	24.28 ms
7ac3378+dirty	410.67 ms	442.60 ms	31.92 ms
4953e94+dirty	398.80 ms	431.81 ms	33.01 ms
5fe1c6c+dirty	365.84 ms	408.62 ms	42.78 ms

App size

Revision	Plain	With Sentry	Diff
8929511+dirty	43.94 MiB	49.02 MiB	5.08 MiB
23598c3+dirty	43.94 MiB	49.02 MiB	5.08 MiB
d2eadf8+dirty	48.30 MiB	53.48 MiB	5.18 MiB
5c1e987+dirty	43.94 MiB	48.94 MiB	5.00 MiB
c004dae+dirty	48.30 MiB	53.49 MiB	5.19 MiB
ad66da3+dirty	48.30 MiB	53.49 MiB	5.19 MiB
2c735cc+dirty	43.94 MiB	48.94 MiB	5.00 MiB
7ac3378+dirty	43.94 MiB	48.99 MiB	5.05 MiB
4953e94+dirty	43.94 MiB	48.94 MiB	5.00 MiB
5fe1c6c+dirty	43.94 MiB	49.00 MiB	5.06 MiB

[antonis]

📢 Type of change

• Bugfix
• New feature
• Enhancement
• Refactoring

📜 Description

Walks the React fiber tree downward (child/sibling pointers) to extract text content from children of touched components. This text is used as a lowest-priority label fallback when no explicit label (sentry-label, custom labelKey) is set.

For example, a button like:

<TouchableOpacityonPress={save}><Text>Save workout</Text></TouchableOpacity>

will now produce a breadcrumb with label "Save workout" instead of just "TouchableOpacity".

Masking behavior

• When maskAllText is enabled (the default for replay users): text extraction is automatically disabled to avoid leaking masked content via breadcrumbs. No behavior change for these users.
• When maskAllText is explicitly false: text extraction is enabled.
• When MobileReplay integration is not installed: text extraction is enabled. This is a behavior change — users without replay will now see text labels in their touch breadcrumbs where previously they only saw component names. This can surface new data in breadcrumbs (component text content). Users can opt out via extractTextFromChildren: false on TouchEventBoundary.
• Per-view Sentry.Mask boundaries are respected: text inside <Sentry.Mask> is never extracted.

Safety limits

• Max text length: 64 characters (truncated with ...)
• Max depth: 3 levels of child traversal
• Max siblings: 5 per level (prevents runaway traversal in long lists)

New prop

extractTextFromChildren (default true) — set to false to opt out entirely.

Label priority (lowest to highest)

1. Extracted text children ← new
2. Custom labelKey prop value
3. sentry-label prop

💡 Motivation and Context

Touch breadcrumbs currently produce unhelpful labels like "Touch event within element: View" which makes Session Replay AI summaries and issue debugging less useful. This change automatically extracts meaningful labels from component text content.

Closes#6097

💚 How did you test it?

• 11 new unit tests covering: basic extraction, nested children, siblings, truncation, masking gate (maskAllText: true, false, undefined), Sentry.Mask boundary, priority over extracted text, extractTextFromChildren: false opt-out, raw text fiber nodes, integration without options
• All 31 touchevents tests pass
• Type check passes (no new TS errors)
• Lint passes (0 warnings, 0 errors)

📝 Checklist

• I added tests to verify changes
• No new PII added or SDK only sends newly added PII if sendDefaultPII is enabled
• I updated the docs if needed docs(react-native): Document text extraction from children for touch breadcrumbs sentry-docs#17665
• I updated the wizard if needed.
• All tests passing
• No breaking changes

🔮 Next steps

[github-actions]

Semver Impact of This PR

⚪ None (no version bump detected)

📋 Changelog Preview

This is how your changes will appear in the changelog.
Entries from this PR are highlighted with a left border (blockquote style).

---

• feat(core): Extract text from children of touched components for breadcrumb labels by antonis in #6106

• chore(deps): bump fast-uri from 3.0.1 to 3.1.2 by dependabot in #6121
• chore(deps): bump fast-xml-builder from 1.1.5 to 1.2.0 by dependabot in #6120
• chore(deps): bump socks to ^2.8.8 to fix ip-address vulnerability by antonis in #6117
• chore(deps): bump uuid to ^13.0.1 to fix buffer bounds check vulnerability by antonis in #6118
• test(replay): Add passthrough tests for device-state replay breadcrumbs by antonis in #6115
• chore(deps): update JavaScript SDK to v10.52.0 by github-actions in #6108
• chore(deps): bump basic-ftp from 5.3.0 to 5.3.1 by dependabot in #6111

---

_{🤖 This preview updates automatically when you update the PR.}

[github-actions]

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

Generated by 🚫 dangerJS against ae22e6c

[antonis]

@sentry review

[antonis]

@cursor review

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

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

[lucas-zimerman]

Would it be possible to add a depth limit & sibling limit test?

[antonis]

Would it be possible to add a depth limit & sibling limit test?

Good idea 👍 Added with 6fdacc4

[lucas-zimerman]

LGTM!

[sentry]

📲 Install Builds

Android

🔗 App Name	App ID	Version	Configuration
Sentry RN	io.sentry.reactnative.sample	8.11.0 (87)	Release

⚙️ sentry-react-native Build Distribution Settings

[github-actions]

iOS (legacy) Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	3838.73 ms	1216.71 ms	-2622.02 ms
Size	5.15 MiB	6.67 MiB	1.51 MiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
3817909+dirty	1183.90 ms	1187.50 ms	3.60 ms
23598c3+dirty	1207.00 ms	1209.90 ms	2.90 ms
890d145+dirty	1223.59 ms	1231.37 ms	7.78 ms
bc0d8cf+dirty	3830.33 ms	1220.52 ms	-2609.81 ms
8929511+dirty	1216.42 ms	1219.02 ms	2.60 ms
4b87b12+dirty	1212.90 ms	1222.09 ms	9.19 ms
7ac3378+dirty	1213.37 ms	1218.15 ms	4.78 ms
5c1e987+dirty	1204.30 ms	1222.15 ms	17.85 ms
5569641+dirty	3839.22 ms	1231.30 ms	-2607.91 ms
c004dae+dirty	3850.32 ms	1227.79 ms	-2622.53 ms

App size

Revision	Plain	With Sentry	Diff
3817909+dirty	3.38 MiB	4.73 MiB	1.35 MiB
23598c3+dirty	3.38 MiB	4.80 MiB	1.42 MiB
890d145+dirty	3.38 MiB	4.77 MiB	1.38 MiB
bc0d8cf+dirty	5.15 MiB	6.67 MiB	1.51 MiB
8929511+dirty	3.38 MiB	4.80 MiB	1.42 MiB
4b87b12+dirty	3.38 MiB	4.77 MiB	1.39 MiB
7ac3378+dirty	3.38 MiB	4.76 MiB	1.38 MiB
5c1e987+dirty	3.38 MiB	4.73 MiB	1.35 MiB
5569641+dirty	5.15 MiB	6.67 MiB	1.51 MiB
c004dae+dirty	5.15 MiB	6.67 MiB	1.51 MiB

[github-actions]

Android (legacy) Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	408.41 ms	445.86 ms	37.45 ms
Size	48.30 MiB	53.49 MiB	5.19 MiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
4953e94+dirty	442.02 ms	456.52 ms	14.50 ms
04207c4+dirty	459.19 ms	518.54 ms	59.35 ms
2c735cc+dirty	414.09 ms	438.47 ms	24.38 ms
44c8b3f+dirty	414.20 ms	457.28 ms	43.08 ms
d2eadf8+dirty	414.64 ms	454.56 ms	39.92 ms
c004dae+dirty	412.86 ms	481.50 ms	68.64 ms
ad66da3+dirty	468.46 ms	533.56 ms	65.10 ms
8929511+dirty	405.33 ms	452.16 ms	46.83 ms
100ce80+dirty	463.66 ms	539.56 ms	75.90 ms
df5d108+dirty	527.06 ms	603.58 ms	76.52 ms

App size

Revision	Plain	With Sentry	Diff
4953e94+dirty	43.75 MiB	48.08 MiB	4.33 MiB
04207c4+dirty	43.75 MiB	48.12 MiB	4.37 MiB
2c735cc+dirty	43.75 MiB	48.08 MiB	4.33 MiB
44c8b3f+dirty	48.30 MiB	53.46 MiB	5.15 MiB
d2eadf8+dirty	48.30 MiB	53.48 MiB	5.18 MiB
c004dae+dirty	48.30 MiB	53.49 MiB	5.19 MiB
ad66da3+dirty	48.30 MiB	53.49 MiB	5.19 MiB
8929511+dirty	43.75 MiB	48.16 MiB	4.41 MiB
100ce80+dirty	48.30 MiB	53.46 MiB	5.15 MiB
df5d108+dirty	43.75 MiB	48.08 MiB	4.33 MiB

[github-actions]

iOS (new) Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	3821.24 ms	1229.15 ms	-2592.09 ms
Size	5.15 MiB	6.67 MiB	1.51 MiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
3817909+dirty	1210.76 ms	1215.64 ms	4.89 ms
23598c3+dirty	1223.59 ms	1229.13 ms	5.53 ms
890d145+dirty	1212.98 ms	1220.10 ms	7.12 ms
bc0d8cf+dirty	3834.64 ms	1223.91 ms	-2610.73 ms
8929511+dirty	1223.41 ms	1222.49 ms	-0.92 ms
4b87b12+dirty	1199.49 ms	1199.78 ms	0.29 ms
7ac3378+dirty	1202.35 ms	1198.31 ms	-4.04 ms
5c1e987+dirty	1208.43 ms	1220.72 ms	12.29 ms
5569641+dirty	3824.35 ms	1210.78 ms	-2613.57 ms
c004dae+dirty	3857.82 ms	1224.87 ms	-2632.95 ms

App size

Revision	Plain	With Sentry	Diff
3817909+dirty	3.38 MiB	4.73 MiB	1.35 MiB
23598c3+dirty	3.38 MiB	4.80 MiB	1.42 MiB
890d145+dirty	3.38 MiB	4.77 MiB	1.38 MiB
bc0d8cf+dirty	5.15 MiB	6.67 MiB	1.51 MiB
8929511+dirty	3.38 MiB	4.80 MiB	1.42 MiB
4b87b12+dirty	3.38 MiB	4.77 MiB	1.39 MiB
7ac3378+dirty	3.38 MiB	4.76 MiB	1.38 MiB
5c1e987+dirty	3.38 MiB	4.73 MiB	1.35 MiB
5569641+dirty	5.15 MiB	6.67 MiB	1.51 MiB
c004dae+dirty	5.15 MiB	6.67 MiB	1.51 MiB

[github-actions]

Android (new) Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	405.50 ms	442.51 ms	37.01 ms
Size	48.30 MiB	53.49 MiB	5.19 MiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
8929511+dirty	469.49 ms	502.65 ms	33.16 ms
23598c3+dirty	371.92 ms	420.65 ms	48.74 ms
d2eadf8+dirty	468.02 ms	530.37 ms	62.35 ms
5c1e987+dirty	444.71 ms	475.13 ms	30.42 ms
c004dae+dirty	404.60 ms	430.67 ms	26.07 ms
ad66da3+dirty	411.49 ms	449.38 ms	37.89 ms
2c735cc+dirty	435.20 ms	459.48 ms	24.28 ms
7ac3378+dirty	410.67 ms	442.60 ms	31.92 ms
4953e94+dirty	398.80 ms	431.81 ms	33.01 ms
5fe1c6c+dirty	365.84 ms	408.62 ms	42.78 ms

App size

Revision	Plain	With Sentry	Diff
8929511+dirty	43.94 MiB	49.02 MiB	5.08 MiB
23598c3+dirty	43.94 MiB	49.02 MiB	5.08 MiB
d2eadf8+dirty	48.30 MiB	53.48 MiB	5.18 MiB
5c1e987+dirty	43.94 MiB	48.94 MiB	5.00 MiB
c004dae+dirty	48.30 MiB	53.49 MiB	5.19 MiB
ad66da3+dirty	48.30 MiB	53.49 MiB	5.19 MiB
2c735cc+dirty	43.94 MiB	48.94 MiB	5.00 MiB
7ac3378+dirty	43.94 MiB	48.99 MiB	5.05 MiB
4953e94+dirty	43.94 MiB	48.94 MiB	5.00 MiB
5fe1c6c+dirty	43.94 MiB	49.00 MiB	5.06 MiB

[antonis]

📢 Type of change

• Bugfix
• New feature
• Enhancement
• Refactoring

📜 Description

Walks the React fiber tree downward (child/sibling pointers) to extract text content from children of touched components. This text is used as a lowest-priority label fallback when no explicit label (sentry-label, custom labelKey) is set.

For example, a button like:

<TouchableOpacityonPress={save}><Text>Save workout</Text></TouchableOpacity>

will now produce a breadcrumb with label "Save workout" instead of just "TouchableOpacity".

Masking behavior

• When maskAllText is enabled (the default for replay users): text extraction is automatically disabled to avoid leaking masked content via breadcrumbs. No behavior change for these users.
• When maskAllText is explicitly false: text extraction is enabled.
• When MobileReplay integration is not installed: text extraction is enabled. This is a behavior change — users without replay will now see text labels in their touch breadcrumbs where previously they only saw component names. This can surface new data in breadcrumbs (component text content). Users can opt out via extractTextFromChildren: false on TouchEventBoundary.
• Per-view Sentry.Mask boundaries are respected: text inside <Sentry.Mask> is never extracted.

Safety limits

• Max text length: 64 characters (truncated with ...)
• Max depth: 3 levels of child traversal
• Max siblings: 5 per level (prevents runaway traversal in long lists)

New prop

extractTextFromChildren (default true) — set to false to opt out entirely.

Label priority (lowest to highest)

1. Extracted text children ← new
2. Custom labelKey prop value
3. sentry-label prop

💡 Motivation and Context

Touch breadcrumbs currently produce unhelpful labels like "Touch event within element: View" which makes Session Replay AI summaries and issue debugging less useful. This change automatically extracts meaningful labels from component text content.

Closes#6097

💚 How did you test it?

• 11 new unit tests covering: basic extraction, nested children, siblings, truncation, masking gate (maskAllText: true, false, undefined), Sentry.Mask boundary, priority over extracted text, extractTextFromChildren: false opt-out, raw text fiber nodes, integration without options
• All 31 touchevents tests pass
• Type check passes (no new TS errors)
• Lint passes (0 warnings, 0 errors)

📝 Checklist

• I added tests to verify changes
• No new PII added or SDK only sends newly added PII if sendDefaultPII is enabled
• I updated the docs if needed docs(react-native): Document text extraction from children for touch breadcrumbs sentry-docs#17665
• I updated the wizard if needed.
• All tests passing
• No breaking changes

🔮 Next steps

[github-actions]

Semver Impact of This PR

⚪ None (no version bump detected)

📋 Changelog Preview

This is how your changes will appear in the changelog.
Entries from this PR are highlighted with a left border (blockquote style).

---

• feat(core): Extract text from children of touched components for breadcrumb labels by antonis in #6106

• chore(deps): bump fast-uri from 3.0.1 to 3.1.2 by dependabot in #6121
• chore(deps): bump fast-xml-builder from 1.1.5 to 1.2.0 by dependabot in #6120
• chore(deps): bump socks to ^2.8.8 to fix ip-address vulnerability by antonis in #6117
• chore(deps): bump uuid to ^13.0.1 to fix buffer bounds check vulnerability by antonis in #6118
• test(replay): Add passthrough tests for device-state replay breadcrumbs by antonis in #6115
• chore(deps): update JavaScript SDK to v10.52.0 by github-actions in #6108
• chore(deps): bump basic-ftp from 5.3.0 to 5.3.1 by dependabot in #6111

---

_{🤖 This preview updates automatically when you update the PR.}

[github-actions]

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

Generated by 🚫 dangerJS against ae22e6c

[antonis]

@sentry review

[antonis]

@cursor review

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

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

[lucas-zimerman]

Would it be possible to add a depth limit & sibling limit test?

[antonis]

Would it be possible to add a depth limit & sibling limit test?

Good idea 👍 Added with 6fdacc4

[lucas-zimerman]

LGTM!

[sentry]

📲 Install Builds

Android

🔗 App Name	App ID	Version	Configuration
Sentry RN	io.sentry.reactnative.sample	8.11.0 (87)	Release

⚙️ sentry-react-native Build Distribution Settings

[github-actions]

iOS (legacy) Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	3838.73 ms	1216.71 ms	-2622.02 ms
Size	5.15 MiB	6.67 MiB	1.51 MiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
3817909+dirty	1183.90 ms	1187.50 ms	3.60 ms
23598c3+dirty	1207.00 ms	1209.90 ms	2.90 ms
890d145+dirty	1223.59 ms	1231.37 ms	7.78 ms
bc0d8cf+dirty	3830.33 ms	1220.52 ms	-2609.81 ms
8929511+dirty	1216.42 ms	1219.02 ms	2.60 ms
4b87b12+dirty	1212.90 ms	1222.09 ms	9.19 ms
7ac3378+dirty	1213.37 ms	1218.15 ms	4.78 ms
5c1e987+dirty	1204.30 ms	1222.15 ms	17.85 ms
5569641+dirty	3839.22 ms	1231.30 ms	-2607.91 ms
c004dae+dirty	3850.32 ms	1227.79 ms	-2622.53 ms

App size

Revision	Plain	With Sentry	Diff
3817909+dirty	3.38 MiB	4.73 MiB	1.35 MiB
23598c3+dirty	3.38 MiB	4.80 MiB	1.42 MiB
890d145+dirty	3.38 MiB	4.77 MiB	1.38 MiB
bc0d8cf+dirty	5.15 MiB	6.67 MiB	1.51 MiB
8929511+dirty	3.38 MiB	4.80 MiB	1.42 MiB
4b87b12+dirty	3.38 MiB	4.77 MiB	1.39 MiB
7ac3378+dirty	3.38 MiB	4.76 MiB	1.38 MiB
5c1e987+dirty	3.38 MiB	4.73 MiB	1.35 MiB
5569641+dirty	5.15 MiB	6.67 MiB	1.51 MiB
c004dae+dirty	5.15 MiB	6.67 MiB	1.51 MiB

[github-actions]

Android (legacy) Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	408.41 ms	445.86 ms	37.45 ms
Size	48.30 MiB	53.49 MiB	5.19 MiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
4953e94+dirty	442.02 ms	456.52 ms	14.50 ms
04207c4+dirty	459.19 ms	518.54 ms	59.35 ms
2c735cc+dirty	414.09 ms	438.47 ms	24.38 ms
44c8b3f+dirty	414.20 ms	457.28 ms	43.08 ms
d2eadf8+dirty	414.64 ms	454.56 ms	39.92 ms
c004dae+dirty	412.86 ms	481.50 ms	68.64 ms
ad66da3+dirty	468.46 ms	533.56 ms	65.10 ms
8929511+dirty	405.33 ms	452.16 ms	46.83 ms
100ce80+dirty	463.66 ms	539.56 ms	75.90 ms
df5d108+dirty	527.06 ms	603.58 ms	76.52 ms

App size

Revision	Plain	With Sentry	Diff
4953e94+dirty	43.75 MiB	48.08 MiB	4.33 MiB
04207c4+dirty	43.75 MiB	48.12 MiB	4.37 MiB
2c735cc+dirty	43.75 MiB	48.08 MiB	4.33 MiB
44c8b3f+dirty	48.30 MiB	53.46 MiB	5.15 MiB
d2eadf8+dirty	48.30 MiB	53.48 MiB	5.18 MiB
c004dae+dirty	48.30 MiB	53.49 MiB	5.19 MiB
ad66da3+dirty	48.30 MiB	53.49 MiB	5.19 MiB
8929511+dirty	43.75 MiB	48.16 MiB	4.41 MiB
100ce80+dirty	48.30 MiB	53.46 MiB	5.15 MiB
df5d108+dirty	43.75 MiB	48.08 MiB	4.33 MiB

[github-actions]

iOS (new) Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	3821.24 ms	1229.15 ms	-2592.09 ms
Size	5.15 MiB	6.67 MiB	1.51 MiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
3817909+dirty	1210.76 ms	1215.64 ms	4.89 ms
23598c3+dirty	1223.59 ms	1229.13 ms	5.53 ms
890d145+dirty	1212.98 ms	1220.10 ms	7.12 ms
bc0d8cf+dirty	3834.64 ms	1223.91 ms	-2610.73 ms
8929511+dirty	1223.41 ms	1222.49 ms	-0.92 ms
4b87b12+dirty	1199.49 ms	1199.78 ms	0.29 ms
7ac3378+dirty	1202.35 ms	1198.31 ms	-4.04 ms
5c1e987+dirty	1208.43 ms	1220.72 ms	12.29 ms
5569641+dirty	3824.35 ms	1210.78 ms	-2613.57 ms
c004dae+dirty	3857.82 ms	1224.87 ms	-2632.95 ms

App size

Revision	Plain	With Sentry	Diff
3817909+dirty	3.38 MiB	4.73 MiB	1.35 MiB
23598c3+dirty	3.38 MiB	4.80 MiB	1.42 MiB
890d145+dirty	3.38 MiB	4.77 MiB	1.38 MiB
bc0d8cf+dirty	5.15 MiB	6.67 MiB	1.51 MiB
8929511+dirty	3.38 MiB	4.80 MiB	1.42 MiB
4b87b12+dirty	3.38 MiB	4.77 MiB	1.39 MiB
7ac3378+dirty	3.38 MiB	4.76 MiB	1.38 MiB
5c1e987+dirty	3.38 MiB	4.73 MiB	1.35 MiB
5569641+dirty	5.15 MiB	6.67 MiB	1.51 MiB
c004dae+dirty	5.15 MiB	6.67 MiB	1.51 MiB

[github-actions]

Android (new) Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	405.50 ms	442.51 ms	37.01 ms
Size	48.30 MiB	53.49 MiB	5.19 MiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
8929511+dirty	469.49 ms	502.65 ms	33.16 ms
23598c3+dirty	371.92 ms	420.65 ms	48.74 ms
d2eadf8+dirty	468.02 ms	530.37 ms	62.35 ms
5c1e987+dirty	444.71 ms	475.13 ms	30.42 ms
c004dae+dirty	404.60 ms	430.67 ms	26.07 ms
ad66da3+dirty	411.49 ms	449.38 ms	37.89 ms
2c735cc+dirty	435.20 ms	459.48 ms	24.28 ms
7ac3378+dirty	410.67 ms	442.60 ms	31.92 ms
4953e94+dirty	398.80 ms	431.81 ms	33.01 ms
5fe1c6c+dirty	365.84 ms	408.62 ms	42.78 ms

App size

Revision	Plain	With Sentry	Diff
8929511+dirty	43.94 MiB	49.02 MiB	5.08 MiB
23598c3+dirty	43.94 MiB	49.02 MiB	5.08 MiB
d2eadf8+dirty	48.30 MiB	53.48 MiB	5.18 MiB
5c1e987+dirty	43.94 MiB	48.94 MiB	5.00 MiB
c004dae+dirty	48.30 MiB	53.49 MiB	5.19 MiB
ad66da3+dirty	48.30 MiB	53.49 MiB	5.19 MiB
2c735cc+dirty	43.94 MiB	48.94 MiB	5.00 MiB
7ac3378+dirty	43.94 MiB	48.99 MiB	5.05 MiB
4953e94+dirty	43.94 MiB	48.94 MiB	5.00 MiB
5fe1c6c+dirty	43.94 MiB	49.00 MiB	5.06 MiB

[antonis]

📢 Type of change

• Bugfix
• New feature
• Enhancement
• Refactoring

📜 Description

Walks the React fiber tree downward (child/sibling pointers) to extract text content from children of touched components. This text is used as a lowest-priority label fallback when no explicit label (sentry-label, custom labelKey) is set.

For example, a button like:

<TouchableOpacityonPress={save}><Text>Save workout</Text></TouchableOpacity>

will now produce a breadcrumb with label "Save workout" instead of just "TouchableOpacity".

Masking behavior

• When maskAllText is enabled (the default for replay users): text extraction is automatically disabled to avoid leaking masked content via breadcrumbs. No behavior change for these users.
• When maskAllText is explicitly false: text extraction is enabled.
• When MobileReplay integration is not installed: text extraction is enabled. This is a behavior change — users without replay will now see text labels in their touch breadcrumbs where previously they only saw component names. This can surface new data in breadcrumbs (component text content). Users can opt out via extractTextFromChildren: false on TouchEventBoundary.
• Per-view Sentry.Mask boundaries are respected: text inside <Sentry.Mask> is never extracted.

Safety limits

• Max text length: 64 characters (truncated with ...)
• Max depth: 3 levels of child traversal
• Max siblings: 5 per level (prevents runaway traversal in long lists)

New prop

extractTextFromChildren (default true) — set to false to opt out entirely.

Label priority (lowest to highest)

1. Extracted text children ← new
2. Custom labelKey prop value
3. sentry-label prop

💡 Motivation and Context

Touch breadcrumbs currently produce unhelpful labels like "Touch event within element: View" which makes Session Replay AI summaries and issue debugging less useful. This change automatically extracts meaningful labels from component text content.

Closes#6097

💚 How did you test it?

• 11 new unit tests covering: basic extraction, nested children, siblings, truncation, masking gate (maskAllText: true, false, undefined), Sentry.Mask boundary, priority over extracted text, extractTextFromChildren: false opt-out, raw text fiber nodes, integration without options
• All 31 touchevents tests pass
• Type check passes (no new TS errors)
• Lint passes (0 warnings, 0 errors)

📝 Checklist

• I added tests to verify changes
• No new PII added or SDK only sends newly added PII if sendDefaultPII is enabled
• I updated the docs if needed docs(react-native): Document text extraction from children for touch breadcrumbs sentry-docs#17665
• I updated the wizard if needed.
• All tests passing
• No breaking changes

🔮 Next steps

[github-actions]

Semver Impact of This PR

⚪ None (no version bump detected)

📋 Changelog Preview

This is how your changes will appear in the changelog.
Entries from this PR are highlighted with a left border (blockquote style).

---

• feat(core): Extract text from children of touched components for breadcrumb labels by antonis in #6106

• chore(deps): bump fast-uri from 3.0.1 to 3.1.2 by dependabot in #6121
• chore(deps): bump fast-xml-builder from 1.1.5 to 1.2.0 by dependabot in #6120
• chore(deps): bump socks to ^2.8.8 to fix ip-address vulnerability by antonis in #6117
• chore(deps): bump uuid to ^13.0.1 to fix buffer bounds check vulnerability by antonis in #6118
• test(replay): Add passthrough tests for device-state replay breadcrumbs by antonis in #6115
• chore(deps): update JavaScript SDK to v10.52.0 by github-actions in #6108
• chore(deps): bump basic-ftp from 5.3.0 to 5.3.1 by dependabot in #6111

---

_{🤖 This preview updates automatically when you update the PR.}

[github-actions]

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

Generated by 🚫 dangerJS against ae22e6c

[antonis]

@sentry review

[antonis]

@cursor review

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

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

[lucas-zimerman]

Would it be possible to add a depth limit & sibling limit test?

[antonis]

Would it be possible to add a depth limit & sibling limit test?

Good idea 👍 Added with 6fdacc4

[lucas-zimerman]

LGTM!

[sentry]

📲 Install Builds

Android

🔗 App Name	App ID	Version	Configuration
Sentry RN	io.sentry.reactnative.sample	8.11.0 (87)	Release

⚙️ sentry-react-native Build Distribution Settings

[github-actions]

iOS (legacy) Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	3838.73 ms	1216.71 ms	-2622.02 ms
Size	5.15 MiB	6.67 MiB	1.51 MiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
3817909+dirty	1183.90 ms	1187.50 ms	3.60 ms
23598c3+dirty	1207.00 ms	1209.90 ms	2.90 ms
890d145+dirty	1223.59 ms	1231.37 ms	7.78 ms
bc0d8cf+dirty	3830.33 ms	1220.52 ms	-2609.81 ms
8929511+dirty	1216.42 ms	1219.02 ms	2.60 ms
4b87b12+dirty	1212.90 ms	1222.09 ms	9.19 ms
7ac3378+dirty	1213.37 ms	1218.15 ms	4.78 ms
5c1e987+dirty	1204.30 ms	1222.15 ms	17.85 ms
5569641+dirty	3839.22 ms	1231.30 ms	-2607.91 ms
c004dae+dirty	3850.32 ms	1227.79 ms	-2622.53 ms

App size

Revision	Plain	With Sentry	Diff
3817909+dirty	3.38 MiB	4.73 MiB	1.35 MiB
23598c3+dirty	3.38 MiB	4.80 MiB	1.42 MiB
890d145+dirty	3.38 MiB	4.77 MiB	1.38 MiB
bc0d8cf+dirty	5.15 MiB	6.67 MiB	1.51 MiB
8929511+dirty	3.38 MiB	4.80 MiB	1.42 MiB
4b87b12+dirty	3.38 MiB	4.77 MiB	1.39 MiB
7ac3378+dirty	3.38 MiB	4.76 MiB	1.38 MiB
5c1e987+dirty	3.38 MiB	4.73 MiB	1.35 MiB
5569641+dirty	5.15 MiB	6.67 MiB	1.51 MiB
c004dae+dirty	5.15 MiB	6.67 MiB	1.51 MiB

[github-actions]

Android (legacy) Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	408.41 ms	445.86 ms	37.45 ms
Size	48.30 MiB	53.49 MiB	5.19 MiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
4953e94+dirty	442.02 ms	456.52 ms	14.50 ms
04207c4+dirty	459.19 ms	518.54 ms	59.35 ms
2c735cc+dirty	414.09 ms	438.47 ms	24.38 ms
44c8b3f+dirty	414.20 ms	457.28 ms	43.08 ms
d2eadf8+dirty	414.64 ms	454.56 ms	39.92 ms
c004dae+dirty	412.86 ms	481.50 ms	68.64 ms
ad66da3+dirty	468.46 ms	533.56 ms	65.10 ms
8929511+dirty	405.33 ms	452.16 ms	46.83 ms
100ce80+dirty	463.66 ms	539.56 ms	75.90 ms
df5d108+dirty	527.06 ms	603.58 ms	76.52 ms

App size

Revision	Plain	With Sentry	Diff
4953e94+dirty	43.75 MiB	48.08 MiB	4.33 MiB
04207c4+dirty	43.75 MiB	48.12 MiB	4.37 MiB
2c735cc+dirty	43.75 MiB	48.08 MiB	4.33 MiB
44c8b3f+dirty	48.30 MiB	53.46 MiB	5.15 MiB
d2eadf8+dirty	48.30 MiB	53.48 MiB	5.18 MiB
c004dae+dirty	48.30 MiB	53.49 MiB	5.19 MiB
ad66da3+dirty	48.30 MiB	53.49 MiB	5.19 MiB
8929511+dirty	43.75 MiB	48.16 MiB	4.41 MiB
100ce80+dirty	48.30 MiB	53.46 MiB	5.15 MiB
df5d108+dirty	43.75 MiB	48.08 MiB	4.33 MiB

[github-actions]

iOS (new) Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	3821.24 ms	1229.15 ms	-2592.09 ms
Size	5.15 MiB	6.67 MiB	1.51 MiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
3817909+dirty	1210.76 ms	1215.64 ms	4.89 ms
23598c3+dirty	1223.59 ms	1229.13 ms	5.53 ms
890d145+dirty	1212.98 ms	1220.10 ms	7.12 ms
bc0d8cf+dirty	3834.64 ms	1223.91 ms	-2610.73 ms
8929511+dirty	1223.41 ms	1222.49 ms	-0.92 ms
4b87b12+dirty	1199.49 ms	1199.78 ms	0.29 ms
7ac3378+dirty	1202.35 ms	1198.31 ms	-4.04 ms
5c1e987+dirty	1208.43 ms	1220.72 ms	12.29 ms
5569641+dirty	3824.35 ms	1210.78 ms	-2613.57 ms
c004dae+dirty	3857.82 ms	1224.87 ms	-2632.95 ms

App size

Revision	Plain	With Sentry	Diff
3817909+dirty	3.38 MiB	4.73 MiB	1.35 MiB
23598c3+dirty	3.38 MiB	4.80 MiB	1.42 MiB
890d145+dirty	3.38 MiB	4.77 MiB	1.38 MiB
bc0d8cf+dirty	5.15 MiB	6.67 MiB	1.51 MiB
8929511+dirty	3.38 MiB	4.80 MiB	1.42 MiB
4b87b12+dirty	3.38 MiB	4.77 MiB	1.39 MiB
7ac3378+dirty	3.38 MiB	4.76 MiB	1.38 MiB
5c1e987+dirty	3.38 MiB	4.73 MiB	1.35 MiB
5569641+dirty	5.15 MiB	6.67 MiB	1.51 MiB
c004dae+dirty	5.15 MiB	6.67 MiB	1.51 MiB

[github-actions]

Android (new) Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	405.50 ms	442.51 ms	37.01 ms
Size	48.30 MiB	53.49 MiB	5.19 MiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
8929511+dirty	469.49 ms	502.65 ms	33.16 ms
23598c3+dirty	371.92 ms	420.65 ms	48.74 ms
d2eadf8+dirty	468.02 ms	530.37 ms	62.35 ms
5c1e987+dirty	444.71 ms	475.13 ms	30.42 ms
c004dae+dirty	404.60 ms	430.67 ms	26.07 ms
ad66da3+dirty	411.49 ms	449.38 ms	37.89 ms
2c735cc+dirty	435.20 ms	459.48 ms	24.28 ms
7ac3378+dirty	410.67 ms	442.60 ms	31.92 ms
4953e94+dirty	398.80 ms	431.81 ms	33.01 ms
5fe1c6c+dirty	365.84 ms	408.62 ms	42.78 ms

App size

Revision	Plain	With Sentry	Diff
8929511+dirty	43.94 MiB	49.02 MiB	5.08 MiB
23598c3+dirty	43.94 MiB	49.02 MiB	5.08 MiB
d2eadf8+dirty	48.30 MiB	53.48 MiB	5.18 MiB
5c1e987+dirty	43.94 MiB	48.94 MiB	5.00 MiB
c004dae+dirty	48.30 MiB	53.49 MiB	5.19 MiB
ad66da3+dirty	48.30 MiB	53.49 MiB	5.19 MiB
2c735cc+dirty	43.94 MiB	48.94 MiB	5.00 MiB
7ac3378+dirty	43.94 MiB	48.99 MiB	5.05 MiB
4953e94+dirty	43.94 MiB	48.94 MiB	5.00 MiB
5fe1c6c+dirty	43.94 MiB	49.00 MiB	5.06 MiB

[antonis]

📢 Type of change

• Bugfix
• New feature
• Enhancement
• Refactoring

📜 Description

Walks the React fiber tree downward (child/sibling pointers) to extract text content from children of touched components. This text is used as a lowest-priority label fallback when no explicit label (sentry-label, custom labelKey) is set.

For example, a button like:

<TouchableOpacityonPress={save}><Text>Save workout</Text></TouchableOpacity>

will now produce a breadcrumb with label "Save workout" instead of just "TouchableOpacity".

Masking behavior

• When maskAllText is enabled (the default for replay users): text extraction is automatically disabled to avoid leaking masked content via breadcrumbs. No behavior change for these users.
• When maskAllText is explicitly false: text extraction is enabled.
• When MobileReplay integration is not installed: text extraction is enabled. This is a behavior change — users without replay will now see text labels in their touch breadcrumbs where previously they only saw component names. This can surface new data in breadcrumbs (component text content). Users can opt out via extractTextFromChildren: false on TouchEventBoundary.
• Per-view Sentry.Mask boundaries are respected: text inside <Sentry.Mask> is never extracted.

Safety limits

• Max text length: 64 characters (truncated with ...)
• Max depth: 3 levels of child traversal
• Max siblings: 5 per level (prevents runaway traversal in long lists)

New prop

extractTextFromChildren (default true) — set to false to opt out entirely.

Label priority (lowest to highest)

1. Extracted text children ← new
2. Custom labelKey prop value
3. sentry-label prop

💡 Motivation and Context

Touch breadcrumbs currently produce unhelpful labels like "Touch event within element: View" which makes Session Replay AI summaries and issue debugging less useful. This change automatically extracts meaningful labels from component text content.

Closes#6097

💚 How did you test it?

• 11 new unit tests covering: basic extraction, nested children, siblings, truncation, masking gate (maskAllText: true, false, undefined), Sentry.Mask boundary, priority over extracted text, extractTextFromChildren: false opt-out, raw text fiber nodes, integration without options
• All 31 touchevents tests pass
• Type check passes (no new TS errors)
• Lint passes (0 warnings, 0 errors)

📝 Checklist

• I added tests to verify changes
• No new PII added or SDK only sends newly added PII if sendDefaultPII is enabled
• I updated the docs if needed docs(react-native): Document text extraction from children for touch breadcrumbs sentry-docs#17665
• I updated the wizard if needed.
• All tests passing
• No breaking changes

🔮 Next steps

[github-actions]

Semver Impact of This PR

⚪ None (no version bump detected)

📋 Changelog Preview

This is how your changes will appear in the changelog.
Entries from this PR are highlighted with a left border (blockquote style).

---

• feat(core): Extract text from children of touched components for breadcrumb labels by antonis in #6106

• chore(deps): bump fast-uri from 3.0.1 to 3.1.2 by dependabot in #6121
• chore(deps): bump fast-xml-builder from 1.1.5 to 1.2.0 by dependabot in #6120
• chore(deps): bump socks to ^2.8.8 to fix ip-address vulnerability by antonis in #6117
• chore(deps): bump uuid to ^13.0.1 to fix buffer bounds check vulnerability by antonis in #6118
• test(replay): Add passthrough tests for device-state replay breadcrumbs by antonis in #6115
• chore(deps): update JavaScript SDK to v10.52.0 by github-actions in #6108
• chore(deps): bump basic-ftp from 5.3.0 to 5.3.1 by dependabot in #6111

---

_{🤖 This preview updates automatically when you update the PR.}

[github-actions]

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

Generated by 🚫 dangerJS against ae22e6c

[antonis]

@sentry review

[antonis]

@cursor review

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

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

[lucas-zimerman]

Would it be possible to add a depth limit & sibling limit test?

[antonis]

Would it be possible to add a depth limit & sibling limit test?

Good idea 👍 Added with 6fdacc4

[lucas-zimerman]

LGTM!

[sentry]

📲 Install Builds

Android

🔗 App Name	App ID	Version	Configuration
Sentry RN	io.sentry.reactnative.sample	8.11.0 (87)	Release

⚙️ sentry-react-native Build Distribution Settings

[github-actions]

iOS (legacy) Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	3838.73 ms	1216.71 ms	-2622.02 ms
Size	5.15 MiB	6.67 MiB	1.51 MiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
3817909+dirty	1183.90 ms	1187.50 ms	3.60 ms
23598c3+dirty	1207.00 ms	1209.90 ms	2.90 ms
890d145+dirty	1223.59 ms	1231.37 ms	7.78 ms
bc0d8cf+dirty	3830.33 ms	1220.52 ms	-2609.81 ms
8929511+dirty	1216.42 ms	1219.02 ms	2.60 ms
4b87b12+dirty	1212.90 ms	1222.09 ms	9.19 ms
7ac3378+dirty	1213.37 ms	1218.15 ms	4.78 ms
5c1e987+dirty	1204.30 ms	1222.15 ms	17.85 ms
5569641+dirty	3839.22 ms	1231.30 ms	-2607.91 ms
c004dae+dirty	3850.32 ms	1227.79 ms	-2622.53 ms

App size

Revision	Plain	With Sentry	Diff
3817909+dirty	3.38 MiB	4.73 MiB	1.35 MiB
23598c3+dirty	3.38 MiB	4.80 MiB	1.42 MiB
890d145+dirty	3.38 MiB	4.77 MiB	1.38 MiB
bc0d8cf+dirty	5.15 MiB	6.67 MiB	1.51 MiB
8929511+dirty	3.38 MiB	4.80 MiB	1.42 MiB
4b87b12+dirty	3.38 MiB	4.77 MiB	1.39 MiB
7ac3378+dirty	3.38 MiB	4.76 MiB	1.38 MiB
5c1e987+dirty	3.38 MiB	4.73 MiB	1.35 MiB
5569641+dirty	5.15 MiB	6.67 MiB	1.51 MiB
c004dae+dirty	5.15 MiB	6.67 MiB	1.51 MiB

[github-actions]

Android (legacy) Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	408.41 ms	445.86 ms	37.45 ms
Size	48.30 MiB	53.49 MiB	5.19 MiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
4953e94+dirty	442.02 ms	456.52 ms	14.50 ms
04207c4+dirty	459.19 ms	518.54 ms	59.35 ms
2c735cc+dirty	414.09 ms	438.47 ms	24.38 ms
44c8b3f+dirty	414.20 ms	457.28 ms	43.08 ms
d2eadf8+dirty	414.64 ms	454.56 ms	39.92 ms
c004dae+dirty	412.86 ms	481.50 ms	68.64 ms
ad66da3+dirty	468.46 ms	533.56 ms	65.10 ms
8929511+dirty	405.33 ms	452.16 ms	46.83 ms
100ce80+dirty	463.66 ms	539.56 ms	75.90 ms
df5d108+dirty	527.06 ms	603.58 ms	76.52 ms

App size

Revision	Plain	With Sentry	Diff
4953e94+dirty	43.75 MiB	48.08 MiB	4.33 MiB
04207c4+dirty	43.75 MiB	48.12 MiB	4.37 MiB
2c735cc+dirty	43.75 MiB	48.08 MiB	4.33 MiB
44c8b3f+dirty	48.30 MiB	53.46 MiB	5.15 MiB
d2eadf8+dirty	48.30 MiB	53.48 MiB	5.18 MiB
c004dae+dirty	48.30 MiB	53.49 MiB	5.19 MiB
ad66da3+dirty	48.30 MiB	53.49 MiB	5.19 MiB
8929511+dirty	43.75 MiB	48.16 MiB	4.41 MiB
100ce80+dirty	48.30 MiB	53.46 MiB	5.15 MiB
df5d108+dirty	43.75 MiB	48.08 MiB	4.33 MiB

[github-actions]

iOS (new) Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	3821.24 ms	1229.15 ms	-2592.09 ms
Size	5.15 MiB	6.67 MiB	1.51 MiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
3817909+dirty	1210.76 ms	1215.64 ms	4.89 ms
23598c3+dirty	1223.59 ms	1229.13 ms	5.53 ms
890d145+dirty	1212.98 ms	1220.10 ms	7.12 ms
bc0d8cf+dirty	3834.64 ms	1223.91 ms	-2610.73 ms
8929511+dirty	1223.41 ms	1222.49 ms	-0.92 ms
4b87b12+dirty	1199.49 ms	1199.78 ms	0.29 ms
7ac3378+dirty	1202.35 ms	1198.31 ms	-4.04 ms
5c1e987+dirty	1208.43 ms	1220.72 ms	12.29 ms
5569641+dirty	3824.35 ms	1210.78 ms	-2613.57 ms
c004dae+dirty	3857.82 ms	1224.87 ms	-2632.95 ms

App size

Revision	Plain	With Sentry	Diff
3817909+dirty	3.38 MiB	4.73 MiB	1.35 MiB
23598c3+dirty	3.38 MiB	4.80 MiB	1.42 MiB
890d145+dirty	3.38 MiB	4.77 MiB	1.38 MiB
bc0d8cf+dirty	5.15 MiB	6.67 MiB	1.51 MiB
8929511+dirty	3.38 MiB	4.80 MiB	1.42 MiB
4b87b12+dirty	3.38 MiB	4.77 MiB	1.39 MiB
7ac3378+dirty	3.38 MiB	4.76 MiB	1.38 MiB
5c1e987+dirty	3.38 MiB	4.73 MiB	1.35 MiB
5569641+dirty	5.15 MiB	6.67 MiB	1.51 MiB
c004dae+dirty	5.15 MiB	6.67 MiB	1.51 MiB

[github-actions]

Android (new) Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	405.50 ms	442.51 ms	37.01 ms
Size	48.30 MiB	53.49 MiB	5.19 MiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
8929511+dirty	469.49 ms	502.65 ms	33.16 ms
23598c3+dirty	371.92 ms	420.65 ms	48.74 ms
d2eadf8+dirty	468.02 ms	530.37 ms	62.35 ms
5c1e987+dirty	444.71 ms	475.13 ms	30.42 ms
c004dae+dirty	404.60 ms	430.67 ms	26.07 ms
ad66da3+dirty	411.49 ms	449.38 ms	37.89 ms
2c735cc+dirty	435.20 ms	459.48 ms	24.28 ms
7ac3378+dirty	410.67 ms	442.60 ms	31.92 ms
4953e94+dirty	398.80 ms	431.81 ms	33.01 ms
5fe1c6c+dirty	365.84 ms	408.62 ms	42.78 ms

App size

Revision	Plain	With Sentry	Diff
8929511+dirty	43.94 MiB	49.02 MiB	5.08 MiB
23598c3+dirty	43.94 MiB	49.02 MiB	5.08 MiB
d2eadf8+dirty	48.30 MiB	53.48 MiB	5.18 MiB
5c1e987+dirty	43.94 MiB	48.94 MiB	5.00 MiB
c004dae+dirty	48.30 MiB	53.49 MiB	5.19 MiB
ad66da3+dirty	48.30 MiB	53.49 MiB	5.19 MiB
2c735cc+dirty	43.94 MiB	48.94 MiB	5.00 MiB
7ac3378+dirty	43.94 MiB	48.99 MiB	5.05 MiB
4953e94+dirty	43.94 MiB	48.94 MiB	5.00 MiB
5fe1c6c+dirty	43.94 MiB	49.00 MiB	5.06 MiB