Skip to content

Commit ea9361d

Browse files
committed
Document optional debugger version
Clarify that browser debugger version is optional, but when provided it should match the immutable deployed build identifier used for browser build lookup and sourcemap resolution. This keeps the SDK contract aligned with graceful degradation when no version is configured.
1 parent 653aee9 commit ea9361d

2 files changed

Lines changed: 4 additions & 1 deletion

File tree

packages/debugger/README.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,10 +17,12 @@ datadogDebugger.init({
1717
site: '<DATADOG_SITE>',
1818
service: 'my-web-application',
1919
// env: 'production',
20-
// version: '1.0.0',
20+
// version: 'my-deployed-build-version',
2121
})
2222
```
2323

24+
If provided, `version` should be set to the immutable deployed browser build identifier used for source map upload and browser build resolution. If omitted, debugger delivery and snapshots still work, but browser build lookup and source-aware resolution may be unavailable.
25+
2426
If [Datadog RUM][3] is also initialized on the page, debugger snapshots automatically include RUM context (session, view, user action) without any additional configuration.
2527

2628
## Troubleshooting

packages/debugger/src/entries/main.ts

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -88,6 +88,7 @@ export interface DebuggerPublicApi extends PublicApi {
8888
* service: 'my-app',
8989
* site: 'datadoghq.com',
9090
* env: 'production'
91+
* version: 'my-deployed-build-version',
9192
* })
9293
* ```
9394
*/

0 commit comments

Comments
 (0)