Skip to content
Projects
Groups
Snippets
Help
Loading...
Sign in
Toggle navigation
N
next.js
Project
Project
Details
Activity
Cycle Analytics
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Charts
Issues
0
Issues
0
List
Board
Labels
Milestones
Merge Requests
0
Merge Requests
0
CI / CD
CI / CD
Pipelines
Jobs
Schedules
Charts
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Charts
Create a new issue
Jobs
Commits
Issue Boards
Open sidebar
Alex
next.js
Commits
b3b97bc4
Unverified
Commit
b3b97bc4
authored
Nov 17, 2025
by
Sebastian "Sebbie" Silbermann
Committed by
GitHub
Nov 17, 2025
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Allow attaching a debugger when `next dev` is already running (#86083)
parent
a3aadbd3
Show whitespace changes
Inline
Side-by-side
Showing
10 changed files
with
134 additions
and
40 deletions
+134
-40
errors.json
packages/next/errors.json
+2
-1
error-overlay-toolbar.tsx
...ts/errors/error-overlay-toolbar/error-overlay-toolbar.tsx
+6
-1
nodejs-inspector-button.stories.tsx
...error-overlay-toolbar/nodejs-inspector-button.stories.tsx
+3
-2
nodejs-inspector-button.tsx
.../errors/error-overlay-toolbar/nodejs-inspector-button.tsx
+62
-33
attach-nodejs-debugger-middleware.ts
...next-devtools/server/attach-nodejs-debugger-middleware.ts
+48
-0
middleware-response.ts
...ages/next/src/next-devtools/server/middleware-response.ts
+7
-2
hot-reloader-turbopack.ts
packages/next/src/server/dev/hot-reloader-turbopack.ts
+2
-0
hot-reloader-webpack.ts
packages/next/src/server/dev/hot-reloader-webpack.ts
+2
-0
next-dev-server.ts
packages/next/src/server/dev/next-dev-server.ts
+1
-0
devtool-copy-button.test.ts
...t/app-dir/devtool-copy-button/devtool-copy-button.test.ts
+1
-1
No files found.
packages/next/errors.json
View file @
b3b97bc4
...
@@ -924,5 +924,6 @@
...
@@ -924,5 +924,6 @@
"923"
:
"%s is being parsed as a normalized route, but it has a route group or parallel route segment."
,
"923"
:
"%s is being parsed as a normalized route, but it has a route group or parallel route segment."
,
"924"
:
"Invalid interception route: %s"
,
"924"
:
"Invalid interception route: %s"
,
"925"
:
"You cannot define a route with the same specificity as an optional catch-all route (
\"
%s
\"
and
\"
/[[...%s]]
\"
)."
,
"925"
:
"You cannot define a route with the same specificity as an optional catch-all route (
\"
%s
\"
and
\"
/[[...%s]]
\"
)."
,
"926"
:
"Optional route parameters are not yet supported (
\"
[%s]
\"
) in route
\"
%s
\"
."
"926"
:
"Optional route parameters are not yet supported (
\"
[%s]
\"
) in route
\"
%s
\"
."
,
"927"
:
"No debug targets found"
}
}
packages/next/src/next-devtools/dev-overlay/components/errors/error-overlay-toolbar/error-overlay-toolbar.tsx
View file @
b3b97bc4
...
@@ -23,7 +23,8 @@ export function ErrorOverlayToolbar({
...
@@ -23,7 +23,8 @@ export function ErrorOverlayToolbar({
<
CopyErrorButton
error=
{
error
}
generateErrorInfo=
{
generateErrorInfo
}
/>
<
CopyErrorButton
error=
{
error
}
generateErrorInfo=
{
generateErrorInfo
}
/>
<
DocsLinkButton
errorMessage=
{
error
.
message
}
/>
<
DocsLinkButton
errorMessage=
{
error
.
message
}
/>
<
NodejsInspectorButton
<
NodejsInspectorButton
devtoolsFrontendUrl=
{
debugInfo
?.
devtoolsFrontendUrl
}
key=
{
debugInfo
?.
devtoolsFrontendUrl
}
defaultDevtoolsFrontendUrl=
{
debugInfo
?.
devtoolsFrontendUrl
}
/>
/>
</
span
>
</
span
>
)
)
...
@@ -73,6 +74,10 @@ export const styles = `
...
@@ -73,6 +74,10 @@ export const styles = `
}
}
}
}
.nodejs-inspector-button[data-pending='true'] {
cursor: wait;
}
.error-overlay-toolbar-button-icon {
.error-overlay-toolbar-button-icon {
color: var(--color-gray-900);
color: var(--color-gray-900);
}
}
...
...
packages/next/src/next-devtools/dev-overlay/components/errors/error-overlay-toolbar/nodejs-inspector-button.stories.tsx
View file @
b3b97bc4
...
@@ -15,12 +15,13 @@ type Story = StoryObj<typeof NodejsInspectorButton>
...
@@ -15,12 +15,13 @@ type Story = StoryObj<typeof NodejsInspectorButton>
export
const
WithDevtoolsUrl
:
Story
=
{
export
const
WithDevtoolsUrl
:
Story
=
{
args
:
{
args
:
{
devtoolsFrontendUrl
:
'chrome-devtools://devtools/bundled/inspector.html'
,
defaultDevtoolsFrontendUrl
:
'chrome-devtools://devtools/bundled/inspector.html'
,
},
},
}
}
export
const
WithoutDevtoolsUrl
:
Story
=
{
export
const
WithoutDevtoolsUrl
:
Story
=
{
args
:
{
args
:
{
devtoolsFrontendUrl
:
undefined
,
de
faultDe
vtoolsFrontendUrl
:
undefined
,
},
},
}
}
packages/next/src/next-devtools/dev-overlay/components/errors/error-overlay-toolbar/nodejs-inspector-button.tsx
View file @
b3b97bc4
import
{
startTransition
,
useActionState
,
useEffect
}
from
'react'
import
{
CopyButton
}
from
'../../copy-button'
import
{
CopyButton
}
from
'../../copy-button'
// Inline this helper to avoid widely used across the codebase,
// as for this feature the Chrome detector doesn't need to be super accurate.
function
isChrome
()
{
if
(
typeof
window
===
'undefined'
)
return
false
const
isChromium
=
'chrome'
in
window
&&
window
.
chrome
const
vendorName
=
window
.
navigator
.
vendor
return
(
isChromium
!==
null
&&
isChromium
!==
undefined
&&
vendorName
===
'Google Inc.'
)
}
const
isChromeBrowser
=
isChrome
()
function
NodeJsIcon
(
props
:
any
)
{
function
NodeJsIcon
(
props
:
any
)
{
return
(
return
(
<
svg
<
svg
...
@@ -248,41 +233,85 @@ function NodeJsDisabledIcon(props: any) {
...
@@ -248,41 +233,85 @@ function NodeJsDisabledIcon(props: any) {
)
)
}
}
const
label
=
'Learn more about enabling Node.js inspector for server code with Chrome DevTools'
export
function
NodejsInspectorButton
({
export
function
NodejsInspectorButton
({
devtoolsFrontendUrl
,
de
faultDe
vtoolsFrontendUrl
,
}:
{
}:
{
devtoolsFrontendUrl
:
string
|
undefined
de
faultDe
vtoolsFrontendUrl
:
string
|
undefined
})
{
})
{
const
content
=
devtoolsFrontendUrl
||
''
const
[
devtoolsFrontendUrlState
,
attachDebuggerAction
,
isAttachingDebugger
]
=
const
disabled
=
!
content
||
!
isChromeBrowser
useActionState
<
if
(
disabled
)
{
|
{
status
:
'fulfilled'
;
value
:
string
|
undefined
}
|
{
status
:
'rejected'
;
reason
:
unknown
}
>
(
async
()
=>
{
try
{
const
response
=
await
fetch
(
'/__nextjs_attach-nodejs-inspector'
,
{
method
:
'POST'
,
})
if
(
!
response
.
ok
)
{
throw
new
Error
(
`
${
response
.
status
}
${
response
.
statusText
}
:
${
await
response
.
text
()}
`
)
}
const
devtoolsFrontendUrl
=
await
response
.
json
()
return
{
status
:
'fulfilled'
,
value
:
devtoolsFrontendUrl
,
}
}
catch
(
cause
)
{
return
{
status
:
'rejected'
,
reason
:
new
Error
(
'Failed to attach Node.js inspector: '
+
// TODO: Use `cause` property once Redbox supports displaying `cause`
String
(
cause
)
),
}
}
},
{
status
:
'fulfilled'
,
value
:
defaultDevtoolsFrontendUrl
}
)
const
devtoolsFrontendUrl
=
devtoolsFrontendUrlState
.
status
===
'fulfilled'
?
devtoolsFrontendUrlState
.
value
:
undefined
useEffect
(()
=>
{
if
(
devtoolsFrontendUrlState
.
status
===
'rejected'
)
{
console
.
error
(
devtoolsFrontendUrlState
.
reason
)
}
},
[
devtoolsFrontendUrlState
])
const
attachDebugger
=
startTransition
.
bind
(
null
,
attachDebuggerAction
)
if
(
devtoolsFrontendUrl
===
undefined
)
{
return
(
return
(
<
a
<
button
title=
{
label
}
aria
-
label=
{
label
}
className=
"nodejs-inspector-button"
className=
"nodejs-inspector-button"
href=
{
`https://nextjs.org/docs/app/building-your-application/configuring/debugging#server-side-code`
}
data
-
pending=
{
isAttachingDebugger
}
target=
"_blank"
onClick=
{
isAttachingDebugger
?
undefined
:
attachDebugger
}
rel=
"noopener noreferrer"
title=
{
devtoolsFrontendUrlState
.
status
===
'rejected'
?
'Retry attaching Node.js inspector'
:
'Attach Node.js inspector'
}
>
>
<
NodeJsDisabledIcon
<
NodeJsDisabledIcon
className=
"error-overlay-toolbar-button-icon"
className=
"error-overlay-toolbar-button-icon"
width=
{
14
}
width=
{
14
}
height=
{
14
}
height=
{
14
}
/>
/>
</
a
>
</
button
>
)
)
}
}
return
(
return
(
<
CopyButton
<
CopyButton
data
-
nextjs
-
data
-
runtime
-
error
-
copy
-
devtools
-
url
data
-
nextjs
-
data
-
runtime
-
error
-
copy
-
devtools
-
url
className=
"nodejs-inspector-button"
className=
"nodejs-inspector-button"
actionLabel=
{
'Copy
Chrome DevTools URL
'
}
actionLabel=
{
'Copy
DevTools URL for Chrome
'
}
successLabel=
"Copied"
successLabel=
"Copied"
content=
{
content
}
content=
{
devtoolsFrontendUrl
}
icon=
{
icon=
{
<
NodeJsIcon
<
NodeJsIcon
className=
"error-overlay-toolbar-button-icon"
className=
"error-overlay-toolbar-button-icon"
...
...
packages/next/src/next-devtools/server/attach-nodejs-debugger-middleware.ts
0 → 100644
View file @
b3b97bc4
import
{
middlewareResponse
}
from
'./middleware-response'
import
type
{
ServerResponse
,
IncomingMessage
}
from
'http'
import
*
as
inspector
from
'inspector'
export
function
getAttachNodejsDebuggerMiddleware
()
{
return
async
function
(
req
:
IncomingMessage
,
res
:
ServerResponse
,
next
:
()
=>
void
):
Promise
<
void
>
{
const
{
pathname
}
=
new
URL
(
`http://n
${
req
.
url
}
`
)
if
(
pathname
!==
'/__nextjs_attach-nodejs-inspector'
)
{
return
next
()
}
try
{
const
isInspecting
=
inspector
.
url
()
!==
undefined
const
debugPort
=
process
.
debugPort
if
(
!
isInspecting
)
{
// Node.js will already log that the inspector is listening.
inspector
.
open
(
debugPort
)
}
const
inspectorURLRaw
=
inspector
.
url
()
if
(
inspectorURLRaw
===
undefined
)
{
// could not open, possibly because already in use.
return
middlewareResponse
.
badRequest
(
res
,
`Failed to open port "
${
debugPort
}
". Address may be already in use.`
)
}
const
inspectorURL
=
new
URL
(
inspectorURLRaw
)
const
debugInfoListResponse
=
await
fetch
(
`http://
${
inspectorURL
.
host
}
/json/list`
)
const
debugInfoList
=
await
debugInfoListResponse
.
json
()
if
(
!
Array
.
isArray
(
debugInfoList
)
||
debugInfoList
.
length
===
0
)
{
throw
new
Error
(
'No debug targets found'
)
}
return
middlewareResponse
.
json
(
res
,
debugInfoList
[
0
].
devtoolsFrontendUrl
)
}
catch
(
error
)
{
return
middlewareResponse
.
internalServerError
(
res
)
}
}
}
packages/next/src/next-devtools/server/middleware-response.ts
View file @
b3b97bc4
...
@@ -6,9 +6,14 @@ export const middlewareResponse = {
...
@@ -6,9 +6,14 @@ export const middlewareResponse = {
res
.
statusCode
=
204
res
.
statusCode
=
204
res
.
end
(
'No Content'
)
res
.
end
(
'No Content'
)
},
},
badRequest
(
res
:
ServerResponse
)
{
badRequest
(
res
:
ServerResponse
,
reason
?:
string
)
{
res
.
statusCode
=
400
res
.
statusCode
=
400
res
.
end
(
'Bad Request'
)
if
(
reason
!==
undefined
)
{
res
.
setHeader
(
'Content-Type'
,
'text/plain'
)
res
.
end
(
reason
)
}
else
{
res
.
end
()
}
},
},
notFound
(
res
:
ServerResponse
)
{
notFound
(
res
:
ServerResponse
)
{
res
.
statusCode
=
404
res
.
statusCode
=
404
...
...
packages/next/src/server/dev/hot-reloader-turbopack.ts
View file @
b3b97bc4
...
@@ -107,6 +107,7 @@ import {
...
@@ -107,6 +107,7 @@ import {
devToolsConfigMiddleware
,
devToolsConfigMiddleware
,
getDevToolsConfig
,
getDevToolsConfig
,
}
from
'../../next-devtools/server/devtools-config-middleware'
}
from
'../../next-devtools/server/devtools-config-middleware'
import
{
getAttachNodejsDebuggerMiddleware
}
from
'../../next-devtools/server/attach-nodejs-debugger-middleware'
import
{
import
{
connectReactDebugChannel
,
connectReactDebugChannel
,
connectReactDebugChannelForHtmlRequest
,
connectReactDebugChannelForHtmlRequest
,
...
@@ -773,6 +774,7 @@ export async function createHotReloaderTurbopack(
...
@@ -773,6 +774,7 @@ export async function createHotReloaderTurbopack(
})
})
},
},
}),
}),
getAttachNodejsDebuggerMiddleware
(),
...(
nextConfig
.
experimental
.
mcpServer
...(
nextConfig
.
experimental
.
mcpServer
?
[
?
[
getMcpMiddleware
({
getMcpMiddleware
({
...
...
packages/next/src/server/dev/hot-reloader-webpack.ts
View file @
b3b97bc4
...
@@ -96,6 +96,7 @@ import {
...
@@ -96,6 +96,7 @@ import {
devToolsConfigMiddleware
,
devToolsConfigMiddleware
,
getDevToolsConfig
,
getDevToolsConfig
,
}
from
'../../next-devtools/server/devtools-config-middleware'
}
from
'../../next-devtools/server/devtools-config-middleware'
import
{
getAttachNodejsDebuggerMiddleware
}
from
'../../next-devtools/server/attach-nodejs-debugger-middleware'
import
{
InvariantError
}
from
'../../shared/lib/invariant-error'
import
{
InvariantError
}
from
'../../shared/lib/invariant-error'
import
{
import
{
connectReactDebugChannel
,
connectReactDebugChannel
,
...
@@ -1667,6 +1668,7 @@ export default class HotReloaderWebpack implements NextJsHotReloaderInterface {
...
@@ -1667,6 +1668,7 @@ export default class HotReloaderWebpack implements NextJsHotReloaderInterface {
})
})
},
},
}),
}),
getAttachNodejsDebuggerMiddleware
(),
...(
this
.
config
.
experimental
.
mcpServer
...(
this
.
config
.
experimental
.
mcpServer
?
[
?
[
getMcpMiddleware
({
getMcpMiddleware
({
...
...
packages/next/src/server/dev/next-dev-server.ts
View file @
b3b97bc4
...
@@ -430,6 +430,7 @@ export default class DevServer extends Server {
...
@@ -430,6 +430,7 @@ export default class DevServer extends Server {
*/
*/
if
(
if
(
request
.
url
.
includes
(
'/_next/static'
)
||
request
.
url
.
includes
(
'/_next/static'
)
||
request
.
url
.
includes
(
'/__nextjs_attach-nodejs-inspector'
)
||
request
.
url
.
includes
(
'/__nextjs_original-stack-frame'
)
||
request
.
url
.
includes
(
'/__nextjs_original-stack-frame'
)
||
request
.
url
.
includes
(
'/__nextjs_source-map'
)
||
request
.
url
.
includes
(
'/__nextjs_source-map'
)
||
request
.
url
.
includes
(
'/__nextjs_error_feedback'
)
request
.
url
.
includes
(
'/__nextjs_error_feedback'
)
...
...
test/development/app-dir/devtool-copy-button/devtool-copy-button.test.ts
View file @
b3b97bc4
...
@@ -15,6 +15,6 @@ describe('app-dir - devtool-copy-button', () => {
...
@@ -15,6 +15,6 @@ describe('app-dir - devtool-copy-button', () => {
await
browser
await
browser
.
elementByCss
(
'[data-nextjs-data-runtime-error-copy-devtools-url]'
)
.
elementByCss
(
'[data-nextjs-data-runtime-error-copy-devtools-url]'
)
.
getAttribute
(
'aria-label'
)
.
getAttribute
(
'aria-label'
)
).
toBe
(
'Copy
Chrome DevTools URL
'
)
).
toBe
(
'Copy
DevTools URL for Chrome
'
)
})
})
})
})
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment