✨ Add url option to startView API

[brettburley]

Motivation

The startView() API currently always captures the URL from window.location.href at the moment it's called. This is a problem for frameworks like React Router v7 in framework mode (and similar async routing setups) where loaders/actions run before window.location is updated. This means the view gets recorded with the previous page's URL, leading to incorrect view data in RUM.

Today, ViewOptions accepts name, service, version, and context, but not url, so there is no way to customize this behavior without adding some non-trivial logic in the beforeSend hook.

Changes

Adds an optional url field to ViewOptions so callers can explicitly provide the destination URL when the browser hasn't updated window.location yet. Falls back to location.href when not provided (no behavior change for existing users).

Usage:

DD_RUM.startView({
  name: '/dashboard',
  url: 'https://myapp.com/dashboard',
})

Test instructions

1. Call startView({ name: 'test', url: 'https://example.com/custom-path' }) and verify the view event has view.url set to the provided URL instead of window.location.href
2. Call startView('test') without a URL and verify existing behavior is unchanged (uses location.href)

Checklist

• Tested locally
• Tested on staging
• Added unit tests for this change.
• Added e2e/integration tests for this change.
• Updated documentation and/or relevant AGENTS.md file

[github-actions]

All contributors have signed the CLA ✍️ ✅
_{Posted by the CLA Assistant Lite bot.}

[brettburley]

I have read the CLA Document and I hereby sign the CLA

[BeltranBulbarellaDD]

@brettburley thanks for the contribution!. I'll take over the PR to add some tests and run the CI so we can merge it.

[datadog-datadog-prod-us1]

🎯 Code Coverage (details)
• Patch Coverage: 66.67%
• Overall Coverage: 76.87% (-0.08%)

_{This comment will be updated automatically if new data arrives.
🔗 Commit SHA: 9132945 | Docs | Datadog PR Page | Was this helpful? React with 👍/👎 or give us feedback!}

[bcaudan]

LGTM

A small note on public API doc

We should probably tweak it to:

• not misleading people to think that there is only name, service and version configurable
• not list every options available here

[mormubis]

No URL validation

The url field goes through unvalidated — if someone passes /dashboard instead of a full URL, view.url in the RUM event ends up as an origin-less string. The existing window.location.href path always gives a fully-qualified URL, so this quietly breaks in a way that didn't exist before.

Could normalize with new URL(url, location.href).href to handle relative URLs gracefully, or at least warn + fall back to location.href when the value isn't absolute.