fix(react): conditionally load UI scripts to prevent document.createE… by chriscanin · Pull Request #7769 · clerk/javascript

chriscanin · 2026-02-04T23:37:01Z

Description

This fixes a bug that is happening with core-3 expo release:

Call Stack
  loadClerkUIScript (node_modules/@clerk/expo/node_modules/@clerk/shared/dist/runtime/loadClerkJsScript.js:114:25)
  next (<native>)
  asyncGeneratorStep (node_modules/@babel/runtime/helpers/asyncToGenerator.js:3:17)
  _next (node_modules/@babel/runtime/helpers/asyncToGenerator.js:17:27)
  Promise$argument_0 (node_modules/@babel/runtime/helpers/asyncToGenerator.js:22:12)
  tryCallTwo (address at (InternalBytecode.js:1:1222)
  doResolve (address at (InternalBytecode.js:1:2541)
  Promise (address at (InternalBytecode.js:1:1318)
  <anonymous> (node_modules/@babel/runtime/helpers/asyncToGenerator.js:14:23)
  apply (<native>)
  <global> (node_modules/@clerk/expo/node_modules/@clerk/shared/dist/runtime/loadClerkJsScript.js:102:24)
  _IsomorphicClerk#getClerkUiEntryChunk (node_modules/@clerk/expo/node_modules/@clerk/react/dist/index.js:3440:57)
  next (<native>)
  asyncGeneratorStep (node_modules/@babel/runtime/helpers/asyncToGenerator.js:3:17)
  _next (node_modules/@babel/runtime/helpers/asyncToGenerator.js:17:27)
  Promise$argument_0 (node_modules/@babel/runtime/helpers/asyncToGenerator.js:22:12)
  tryCallTwo (address at (InternalBytecode.js:1:1222)
  doResolve (address at (InternalBytecode.js:1:2541)
  Promise (address at (InternalBytecode.js:1:1318)
  <anonymous> (node_modules/@babel/runtime/helpers/asyncToGenerator.js:14:23)
  apply (<native>)
  _IsomorphicClerk#getClerkUiEntryChunk (node_modules/@clerk/expo/node_modules/@clerk/react/dist/index.js:3433:29)
  _IsomorphicClerk#getEntryChunks (node_modules/@clerk/expo/node_modules/@clerk/react/dist/index.js:3399:58)
  next (<native>)
  asyncGeneratorStep (node_modules/@babel/runtime/helpers/asyncToGenerator.js:3:17)
  _next (node_modules/@babel/runtime/helpers/asyncToGenerator.js:17:27)
  Promise$argument_0 (node_modules/@babel/runtime/helpers/asyncToGenerator.js:22:12)
  tryCallTwo (address at (InternalBytecode.js:1:1222)
  doResolve (address at (InternalBytecode.js:1:2541)
  Promise (address at (InternalBytecode.js:1:1318)
  <anonymous> (node_modules/@babel/runtime/helpers/asyncToGenerator.js:14:23)
  apply (<native>)
  _IsomorphicClerk#getEntryChunks (node_modules/@clerk/expo/node_modules/@clerk/react/dist/index.js:3389:23)
  _IsomorphicClerk#constructor (node_modules/@clerk/expo/node_modules/@clerk/react/dist/index.js:3300:31)
  _IsomorphicClerk.getOrCreateInstance (node_modules/@clerk/expo/node_modules/@clerk/react/dist/index.js:3326:57)
  useLoadedIsomorphicClerk (node_modules/@clerk/expo/node_modules/@clerk/react/dist/index.js:3583:95)
  ClerkProviderBase (node_modules/@clerk/expo/node_modules/@clerk/react/dist/index.js:3561:68)
  callComponent.reactStackBottomFrame (node_modules/react-native/Libraries/Renderer/implementations/ReactFabric-dev.js:15887:29)
  renderWithHooks (node_modules/react-native/Libraries/Renderer/implementations/ReactFabric-dev.js:3857:40)
  updateFunctionComponent (node_modules/react-native/Libraries/Renderer/implementations/ReactFabric-dev.js:7289:34)
  beginWork (node_modules/react-native/Libraries/Renderer/implementations/ReactFabric-dev.js:8541:41)
  runWithFiberInDEV (node_modules/react-native/Libraries/Renderer/implementations/ReactFabric-dev.js:683:21)
  performUnitOfWork (node_modules/react-native/Libraries/Renderer/implementations/ReactFabric-dev.js:12220:39)
  workLoopSync (node_modules/react-native/Libraries/Renderer/implementations/ReactFabric-dev.js:12044:58)
  renderRootSync (node_modules/react-native/Libraries/Renderer/implementations/ReactFabric-dev.js:12024:23)
  performWorkOnRoot (node_modules/react-native/Libraries/Renderer/implementations/ReactFabric-dev.js:11551:27)
  performSyncWorkOnRoot (node_modules/react-native/Libraries/Renderer/implementations/ReactFabric-dev.js:3088:24)
  flushSyncWorkAcrossRoots_impl (node_modules/react-native/Libraries/Renderer/implementations/ReactFabric-dev.js:2942:42)
  processRootScheduleInMicrotask (node_modules/react-native/Libraries/Renderer/implementations/ReactFabric-dev.js:2973:36)
  scheduleMicrotask$argument_0 (node_modules/react-native/Libraries/Renderer/implementations/ReactFabric-dev.js:3108:47) 

Call Stack
  construct (<native>)
  apply (<native>)
  _construct (node_modules/@babel/runtime/helpers/construct.js:4:65)
  Wrapper (node_modules/@babel/runtime/helpers/wrapNativeSuper.js:15:23)
  construct (<native>)
  _callSuper (node_modules/@babel/runtime/helpers/callSuper.js:5:108)
  NamelessError (node_modules/@expo/metro-runtime/src/metroServerLogs.native.ts:102:20)
  captureCurrentStack (node_modules/@expo/metro-runtime/src/metroServerLogs.native.ts:106:27)
  HMRClient.log (node_modules/@expo/metro-runtime/src/metroServerLogs.native.ts:39:79)
  console.level (node_modules/react-native/Libraries/Core/setUpDeveloperTools.js:41:24)
  _IsomorphicClerk#getEntryChunks (node_modules/@clerk/expo/node_modules/@clerk/react/dist/index.js:3411:20)
  throw (<native>)
  asyncGeneratorStep (node_modules/@babel/runtime/helpers/asyncToGenerator.js:3:17)
  _throw (node_modules/@babel/runtime/helpers/asyncToGenerator.js:20:27)
  tryCallOne (address at (InternalBytecode.js:1:1180)
  anonymous (address at (InternalBytecode.js:1:1874)

Checklist

pnpm test runs as expected.
pnpm build runs as expected.
(If applicable) JSDoc comments have been added or updated for any package exports
(If applicable) Documentation has been updated

Type of change

Summary by CodeRabbit

Bug Fixes
- Prevented a ReferenceError in non-browser or server-side contexts by conditionally loading UI scripts only in standard browser environments (when a document context is available), improving stability for server-side rendering and non-browser deployments.

…lement crash in React Native

changeset-bot · 2026-02-04T23:37:05Z

🦋 Changeset detected

Latest commit: 69bf749

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 6 packages

Name	Type
@clerk/react	Patch
@clerk/chrome-extension	Patch
@clerk/expo	Patch
@clerk/nextjs	Patch
@clerk/react-router	Patch
@clerk/tanstack-react-start	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

vercel · 2026-02-04T23:37:06Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
clerk-js-sandbox	Ready	Preview, Comment	Feb 20, 2026 5:21pm

chriscanin · 2026-02-04T23:37:20Z

!snapshot

clerk-cookie · 2026-02-04T23:39:35Z

Hey @chriscanin - the snapshot version command generated the following package versions:

Package	Version
@clerk/agent-toolkit	0.3.0-snapshot.v20260204233758
@clerk/astro	3.0.0-snapshot.v20260204233758
@clerk/backend	3.0.0-snapshot.v20260204233758
@clerk/chrome-extension	3.0.0-snapshot.v20260204233758
@clerk/clerk-js	6.0.0-snapshot.v20260204233758
@clerk/dev-cli	1.0.0-snapshot.v20260204233758
@clerk/expo	3.0.0-snapshot.v20260204233758
@clerk/expo-passkeys	1.0.0-snapshot.v20260204233758
@clerk/express	2.0.0-snapshot.v20260204233758
@clerk/fastify	2.7.0-snapshot.v20260204233758
@clerk/localizations	4.0.0-snapshot.v20260204233758
@clerk/msw	0.0.1-snapshot.v20260204233758
@clerk/nextjs	7.0.0-snapshot.v20260204233758
@clerk/nuxt	2.0.0-snapshot.v20260204233758
@clerk/react	6.0.0-snapshot.v20260204233758
@clerk/react-router	3.0.0-snapshot.v20260204233758
@clerk/shared	4.0.0-snapshot.v20260204233758
@clerk/tanstack-react-start	1.0.0-snapshot.v20260204233758
@clerk/testing	2.0.0-snapshot.v20260204233758
@clerk/ui	1.0.0-snapshot.v20260204233758
@clerk/upgrade	2.0.0-snapshot.v20260204233758
@clerk/vue	2.0.0-snapshot.v20260204233758

Tip: Use the snippet copy button below to quickly install the required packages.
@clerk/agent-toolkit

npm i @clerk/agent-toolkit@0.3.0-snapshot.v20260204233758 --save-exact

@clerk/astro

npm i @clerk/astro@3.0.0-snapshot.v20260204233758 --save-exact

@clerk/backend

npm i @clerk/backend@3.0.0-snapshot.v20260204233758 --save-exact

@clerk/chrome-extension

npm i @clerk/chrome-extension@3.0.0-snapshot.v20260204233758 --save-exact

@clerk/clerk-js

npm i @clerk/clerk-js@6.0.0-snapshot.v20260204233758 --save-exact

@clerk/dev-cli

npm i @clerk/dev-cli@1.0.0-snapshot.v20260204233758 --save-exact

@clerk/expo

npm i @clerk/expo@3.0.0-snapshot.v20260204233758 --save-exact

@clerk/expo-passkeys

npm i @clerk/expo-passkeys@1.0.0-snapshot.v20260204233758 --save-exact

@clerk/express

npm i @clerk/express@2.0.0-snapshot.v20260204233758 --save-exact

@clerk/fastify

npm i @clerk/fastify@2.7.0-snapshot.v20260204233758 --save-exact

@clerk/localizations

npm i @clerk/localizations@4.0.0-snapshot.v20260204233758 --save-exact

@clerk/msw

npm i @clerk/msw@0.0.1-snapshot.v20260204233758 --save-exact

@clerk/nextjs

npm i @clerk/nextjs@7.0.0-snapshot.v20260204233758 --save-exact

@clerk/nuxt

npm i @clerk/nuxt@2.0.0-snapshot.v20260204233758 --save-exact

@clerk/react

npm i @clerk/react@6.0.0-snapshot.v20260204233758 --save-exact

@clerk/react-router

npm i @clerk/react-router@3.0.0-snapshot.v20260204233758 --save-exact

@clerk/shared

npm i @clerk/shared@4.0.0-snapshot.v20260204233758 --save-exact

@clerk/tanstack-react-start

npm i @clerk/tanstack-react-start@1.0.0-snapshot.v20260204233758 --save-exact

@clerk/testing

npm i @clerk/testing@2.0.0-snapshot.v20260204233758 --save-exact

@clerk/ui

npm i @clerk/ui@1.0.0-snapshot.v20260204233758 --save-exact

@clerk/upgrade

npm i @clerk/upgrade@2.0.0-snapshot.v20260204233758 --save-exact

@clerk/vue

npm i @clerk/vue@2.0.0-snapshot.v20260204233758 --save-exact

coderabbitai · 2026-02-04T23:39:44Z

No actionable comments were generated in the recent review. 🎉

📝 Walkthrough

Walkthrough

A changeset file was added documenting a patch that prevents a ReferenceError by loading UI scripts only in standard browser contexts. In packages/react/src/isomorphicClerk.ts the UI constructor is now loaded conditionally: shouldLoadUi is computed as !this.options.Clerk && this.options.standardBrowser !== false; ClerkUI is set only when shouldLoadUi is true and otherwise left undefined. The clerk.load call now receives ui: { ...this.options.ui, ClerkUI }. No public APIs or exported signatures were changed.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name	Status	Explanation	Resolution
Linked Issues check	❓ Inconclusive	The linked issue CORE-3 provides no specific coding requirements or objectives beyond a vague reference to intentional behavior, making it impossible to validate whether the implementation meets the issue's requirements.	Clarify the specific requirements or acceptance criteria in the linked issue to properly assess whether the conditional UI loading implementation meets the intended objectives.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly describes the main change: conditionally loading UI scripts to prevent a document.createElement error in non-browser environments like React Native.
Out of Scope Changes check	✅ Passed	All changes are directly related to the stated objective of conditionally loading UI scripts to prevent document.createElement errors in non-browser contexts.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

pkg-pr-new · 2026-02-04T23:41:03Z

Open in StackBlitz

@clerk/agent-toolkit

npm i https://pkg.pr.new/@clerk/agent-toolkit@7769

@clerk/astro

npm i https://pkg.pr.new/@clerk/astro@7769

@clerk/backend

npm i https://pkg.pr.new/@clerk/backend@7769

@clerk/chrome-extension

npm i https://pkg.pr.new/@clerk/chrome-extension@7769

@clerk/clerk-js

npm i https://pkg.pr.new/@clerk/clerk-js@7769

@clerk/dev-cli

npm i https://pkg.pr.new/@clerk/dev-cli@7769

@clerk/expo

npm i https://pkg.pr.new/@clerk/expo@7769

@clerk/expo-passkeys

npm i https://pkg.pr.new/@clerk/expo-passkeys@7769

@clerk/express

npm i https://pkg.pr.new/@clerk/express@7769

@clerk/fastify

npm i https://pkg.pr.new/@clerk/fastify@7769

@clerk/hono

npm i https://pkg.pr.new/@clerk/hono@7769

@clerk/localizations

npm i https://pkg.pr.new/@clerk/localizations@7769

@clerk/nextjs

npm i https://pkg.pr.new/@clerk/nextjs@7769

@clerk/nuxt

npm i https://pkg.pr.new/@clerk/nuxt@7769

@clerk/react

npm i https://pkg.pr.new/@clerk/react@7769

@clerk/react-router

npm i https://pkg.pr.new/@clerk/react-router@7769

@clerk/shared

npm i https://pkg.pr.new/@clerk/shared@7769

@clerk/tanstack-react-start

npm i https://pkg.pr.new/@clerk/tanstack-react-start@7769

@clerk/testing

npm i https://pkg.pr.new/@clerk/testing@7769

@clerk/ui

npm i https://pkg.pr.new/@clerk/ui@7769

@clerk/upgrade

npm i https://pkg.pr.new/@clerk/upgrade@7769

@clerk/vue

npm i https://pkg.pr.new/@clerk/vue@7769

commit: 69bf749

jacekradko

Thanks @chriscanin !

fix(react): conditionally load UI scripts to prevent document.createE…

0a99783

…lement crash in React Native

chriscanin requested review from alexisintech and jacekradko February 4, 2026 23:37

github-actions bot added react core-3 labels Feb 4, 2026

Merge branch 'main' into chris/document-create-element-bug

d92209a

vercel bot deployed to Preview February 4, 2026 23:38 View deployment

merge main into chris/document-create-element-bug

2290f67

vercel bot deployed to Preview February 10, 2026 01:43 View deployment

fix: move conditional UI loading back inside clerk.loaded check

12d5074

vercel bot deployed to Preview February 10, 2026 01:46 View deployment

Merge branch 'main' into chris/document-create-element-bug

26d7077

vercel bot deployed to Preview February 10, 2026 20:21 View deployment

Merge branch 'main' into chris/document-create-element-bug

5ad0926

vercel bot deployed to Preview February 12, 2026 02:25 View deployment

jacekradko approved these changes Feb 12, 2026

View reviewed changes

Merge branch 'main' into chris/document-create-element-bug

69bf749

vercel bot deployed to Preview February 20, 2026 17:21 View deployment

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

fix(react): conditionally load UI scripts to prevent document.createE…#7769

fix(react): conditionally load UI scripts to prevent document.createE…#7769
chriscanin wants to merge 7 commits intomainfrom
chris/document-create-element-bug

chriscanin commented Feb 4, 2026 •

edited by coderabbitai bot

Loading

Uh oh!

changeset-bot bot commented Feb 4, 2026 •

edited

Loading

Uh oh!

vercel bot commented Feb 4, 2026 •

edited

Loading

Uh oh!

chriscanin commented Feb 4, 2026

Uh oh!

clerk-cookie commented Feb 4, 2026

Uh oh!

coderabbitai bot commented Feb 4, 2026 •

edited

Loading

Walkthrough

❌ Failed checks (1 inconclusive)

Uh oh!

pkg-pr-new bot commented Feb 4, 2026 •

edited

Loading

Uh oh!

jacekradko left a comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Comments

Conversation

chriscanin commented Feb 4, 2026 • edited by coderabbitai bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Checklist

Type of change

Summary by CodeRabbit

Uh oh!

changeset-bot bot commented Feb 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

vercel bot commented Feb 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

chriscanin commented Feb 4, 2026

Uh oh!

clerk-cookie commented Feb 4, 2026

Uh oh!

coderabbitai bot commented Feb 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Walkthrough

❌ Failed checks (1 inconclusive)

Uh oh!

pkg-pr-new bot commented Feb 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

jacekradko left a comment

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Comments

chriscanin commented Feb 4, 2026 •

edited by coderabbitai bot

Loading

changeset-bot bot commented Feb 4, 2026 •

edited

Loading

vercel bot commented Feb 4, 2026 •

edited

Loading

coderabbitai bot commented Feb 4, 2026 •

edited

Loading

pkg-pr-new bot commented Feb 4, 2026 •

edited

Loading