fix(react-router,start): ensure document is only used when available

[lo1tuma]

I’m trying to use react-test-renderer to render a component that uses router hooks or components like Meta. It seems like react-test-renderer is always executing useLayoutEffect and useEffect. Since I don’t have a global window or document object during my test run, some components fail when using document without checking if it exist.

See also discussion #2109.

[nx-cloud]

☁️ Nx Cloud Report

CI is running/has finished running commands for commit 3da769a. As they complete they will appear below. Click to see the status, the terminal output, and the build insights.

📂 See all runs for this CI Pipeline Execution

---

✅ Successfully ran 2 targets

• nx affected --targets=test:eslint,test:unit,test:e2e,test:types,test:build,build --parallel=3
• nx run-many --target=build --exclude=examples/**

---

Sent with 💌 from NxCloud.

[pkg-pr-new]

commit: 3da769a

@tanstack/history

pnpm add https://pkg.pr.new/@tanstack/history@2120

@tanstack/react-cross-context

pnpm add https://pkg.pr.new/@tanstack/react-cross-context@2120

@tanstack/react-router

pnpm add https://pkg.pr.new/@tanstack/react-router@2120

@tanstack/react-router-with-query

pnpm add https://pkg.pr.new/@tanstack/react-router-with-query@2120

@tanstack/router-arktype-adapter

pnpm add https://pkg.pr.new/@tanstack/router-arktype-adapter@2120

@tanstack/router-cli

pnpm add https://pkg.pr.new/@tanstack/router-cli@2120

@tanstack/router-devtools

pnpm add https://pkg.pr.new/@tanstack/router-devtools@2120

@tanstack/router-generator

pnpm add https://pkg.pr.new/@tanstack/router-generator@2120

@tanstack/router-plugin

pnpm add https://pkg.pr.new/@tanstack/router-plugin@2120

@tanstack/router-valibot-adapter

pnpm add https://pkg.pr.new/@tanstack/router-valibot-adapter@2120

@tanstack/router-vite-plugin

pnpm add https://pkg.pr.new/@tanstack/router-vite-plugin@2120

@tanstack/router-zod-adapter

pnpm add https://pkg.pr.new/@tanstack/router-zod-adapter@2120

@tanstack/start

pnpm add https://pkg.pr.new/@tanstack/start@2120

@tanstack/start-vite-plugin

pnpm add https://pkg.pr.new/@tanstack/start-vite-plugin@2120

Open in Stackblitz

More templates

• tanstack-router-react-example-authenticated-routes
• tanstack-router-react-example-basic
• tanstack-router-react-example-basic-default-search-params
• tanstack-router-react-example-basic-file-based
• tanstack-router-react-example-basic-file-based-codesplitting
• tanstack-router-react-example-react-query
• tanstack-router-react-example-basic-react-query-file-based
• tanstack-router-react-example-basic-ssr-file-based
• tanstack-router-react-example-basic-ssr-streaming-file-based
• tanstack-router-react-example-deferred-data
• tanstack-router-react-example-kitchen-sink
• tanstack-router-react-example-kitchen-sink-file-based
• tanstack-router-react-example-kitchen-sink-react-query
• tanstack-router-react-example-kitchen-sink-react-query-file-based
• tanstack-router-react-example-large-file-based
• tanstack-router-react-example-location-masking
• tanstack-router-react-example-navigation-blocking
• tanstack-router-react-example-quickstart
• tanstack-router-react-example-quickstart-file-based
• tanstack-router-react-example-quickstart-rspack-file-based
• tanstack-router-react-example-quickstart-webpack-file-based
• tanstack-router-react-example-scroll-restoration
• tanstack-router-search-validator-adapters
• tanstack-router-example-react-start-basic
• tanstack-router-example-react-start-basic-counter
• tanstack-router-example-react-start-basic-react-query
• tanstack-router-example-react-start-basic-rsc
• tanstack-router-example-react-start-trello-trellaux
• tanstack-router-example-react-start-basic-trellaux
• tanstack-router-react-example-with-framer-motion
• tanstack-router-react-example-with-trpc
• tanstack-router-react-example-with-trpc-react-query

[lo1tuma]

@SeanCassiere thanks for the review. I’ve addressed all comments so far.