Merge 904032ff12 into 73accb5ac1

docs/1.getting-started/8.error-handling.md

@@ -166,8 +166,8 @@ const { data } = await useFetch(`/api/movies/${route.params.slug}`)
 
 if (!data.value) {
   throw createError({
-    statusCode: 404,
-    statusMessage: 'Page Not Found'
+    status: 404,
+    message: 'Page Not Found'
   })
 }
 </script>

docs/2.guide/2.directory-structure/1.server.md

@@ -285,8 +285,8 @@ export default defineEventHandler((event) => {
 
   if (!Number.isInteger(id)) {
     throw createError({
-      statusCode: 400,
-      statusMessage: 'ID should be an integer',
+      status: 400,
+      message: 'ID should be an integer',
     })
   }
   return 'All good'

docs/2.guide/2.directory-structure/3.error.md

@@ -46,8 +46,8 @@ If you have an error with custom fields they will be lost; you should assign the
 
 ```ts
 throw createError({
-  statusCode: 404,
-  statusMessage: 'Page Not Found',
+  status: 404,
+  message: 'Page Not Found',
   data: {
     myCustomField: true
   }

docs/3.api/3.utils/create-error.md

@@ -30,7 +30,7 @@ If you throw an error created with `createError`:
 const route = useRoute()
 const { data } = await useFetch(`/api/movies/${route.params.slug}`)
 if (!data.value) {
-  throw createError({ statusCode: 404, statusMessage: 'Page Not Found' })
+  throw createError({ status: 404, message: 'Page Not Found' })
 }
 </script>
 ```

docs/3.api/3.utils/define-nuxt-route-middleware.md

@@ -39,7 +39,7 @@ You can use route middleware to throw errors and show helpful error messages:
 ```ts [middleware/error.ts]
 export default defineNuxtRouteMiddleware((to) => {
   if (to.params.id === '1') {
-    throw createError({ statusCode: 404, statusMessage: 'Page Not Found' })
+    throw createError({ status: 404, message: 'Page Not Found' })
   }
 })
 ```

packages/nuxt/src/app/compat/interval.ts

@@ -7,7 +7,7 @@ export const setInterval = import.meta.client
   : () => {
       if (import.meta.dev) {
         throw createError({
-          statusCode: 500,
+          status: 500,
           message: intervalError,
         })
       }

packages/nuxt/src/app/components/island-renderer.ts

@@ -24,8 +24,8 @@ export default defineComponent({
 
     if (!component) {
       throw createError({
-        statusCode: 404,
-        statusMessage: `Island component not found: ${props.context.name}`,
+        status: 404,
+        message: `Island component not found: ${props.context.name}`,
       })
     }
 

packages/nuxt/src/app/components/nuxt-stubs.ts

@@ -3,8 +3,8 @@ import { createError } from '../composables/error'
 function renderStubMessage (name: string) {
   throw createError({
     fatal: true,
-    statusCode: 500,
-    statusMessage: `${name} is provided by @nuxt/image. Check your console to install it or run 'npx nuxi@latest module add @nuxt/image'`,
+    status: 500,
+    message: `${name} is provided by @nuxt/image. Check your console to install it or run 'npx nuxi@latest module add @nuxt/image'`,
   })
 }
 

packages/nuxt/src/app/composables/script-stubs.ts

@@ -6,8 +6,8 @@ function renderStubMessage (name: string) {
   if (import.meta.client) {
     throw createError({
       fatal: true,
-      statusCode: 500,
-      statusMessage: message,
+      status: 500,
+      message: message,
     })
   }
 }

packages/nuxt/src/core/runtime/nitro/renderer.ts

@@ -248,8 +248,8 @@ export default defineRenderHandler(async (event): Promise<Partial<RenderResponse
 
   if (ssrError && !('__unenv__' in event.node.req) /* allow internal fetch */) {
     throw createError({
-      statusCode: 404,
-      statusMessage: 'Page Not Found: /__nuxt_error',
+      status: 404,
+      message: 'Page Not Found: /__nuxt_error',
     })
   }
 

packages/vite/src/runtime/vite-node.mjs

@@ -49,8 +49,9 @@ function createRunner () {
         let _err
         try {
           const { message, stack } = formatViteError(errorData, id)
+          // The createError utility in h3 has already removed statusMessage
           _err = createError({
-            statusMessage: 'Vite Error',
+            // statusMessage: 'Vite Error',
             message,
             stack,
           })
@@ -58,8 +59,9 @@ function createRunner () {
           consola.warn('Internal nuxt error while formatting vite-node error. Please report this!', formatError)
           const message = `[vite-node] [TransformError] ${errorData?.message || '-'}`
           consola.error(message, errorData)
+          // The createError utility in h3 has already removed statusMessage
           throw createError({
-            statusMessage: 'Vite Error',
+            // message: 'Vite Error',
             message,
             stack: `${message}\nat ${id}\n` + (errorData?.stack || ''),
           })

packages/vite/src/vite-node.ts

@@ -152,10 +152,10 @@ function createViteNodeApp (ctx: ViteBuildContext, invalidates: Set<string> = ne
     return eventHandler(async (event) => {
       const moduleId = decodeURI(event.path).substring(1)
       if (moduleId === '/') {
-        throw createError({ statusCode: 400 })
+        throw createError({ status: 400 })
       }
       if (isAbsolute(moduleId) && !isFileServingAllowed(moduleId, viteServer)) {
-        throw createError({ statusCode: 403 /* Restricted */ })
+        throw createError({ status: 403 /* Restricted */ })
       }
       const module = await node.fetchModule(moduleId).catch(async (err) => {
         const errorData = {

test/fixtures/basic/pages/error.vue

@@ -12,7 +12,7 @@ const { data, error } = await useAsyncData(() => {
 
 if (error.value) {
   useCookie('some-error').value = 'was set'
-  throw createError({ statusCode: 422, fatal: true, statusMessage: 'This is a custom error' })
+  throw createError({ status: 422, fatal: true, message: 'This is a custom error' })
 }
 
 const state = ref({ attr: 'Hello World' })

test/fixtures/basic/server/api/error.ts

@@ -1,3 +1,3 @@
 export default defineEventHandler(() => {
-  throw createError({ statusCode: 400 })
+  throw createError({ status: 400 })
 })