Error pages (+error.svelte)

Introduction

Error pages help users understand when something goes wrong on a website. They show friendly messages instead of confusing errors.

When a user visits a page that does not exist (404 error).

When the server has a problem and cannot load the page (500 error).

When a user tries to access a page without permission (403 error).

When you want to customize the look and message of error pages in your Svelte app.

Syntax

Svelte

<script>
  export let error;
  export let status;
</script>

<h1>{status}</h1>
<p>{error.message}</p>

The +error.svelte file is a special SvelteKit file that shows error pages automatically.

It receives error and status props to display error details.

Examples

Basic error page showing the status code and error message.

Svelte

<script>
  export let error;
  export let status;
</script>

<h1>Error {status}</h1>
<p>{error.message}</p>

Custom message with status and error details.

Svelte

<script>
  export let error;
  export let status;
</script>

<h1>Oops! Something went wrong.</h1>
<p>Status: {status}</p>
<p>{error.message}</p>

Styled error page with red heading and italic message.

Svelte

<script>
  export let error;
  export let status;
</script>

<style>
  h1 { color: red; }
  p { font-style: italic; }
</style>

<h1>Error {status}</h1>
<p>{error.message}</p>

Sample Program

This is a complete +error.svelte file for SvelteKit. It shows the error status and message in a centered box. It uses semantic HTML and accessibility features like role="alert" and aria-live="assertive" so screen readers announce the error immediately.

Svelte

<script>
  export let error;
  export let status;
</script>

<style>
  main {
    max-width: 600px;
    margin: 3rem auto;
    padding: 1rem;
    font-family: system-ui, sans-serif;
    text-align: center;
  }
  h1 {
    color: #b00020;
    font-size: 3rem;
  }
  p {
    font-size: 1.25rem;
    color: #333;
  }
</style>

<main role="alert" aria-live="assertive">
  <h1>Error {status}</h1>
  <p>{error.message}</p>
</main>

Important Notes

The +error.svelte file automatically catches errors from your routes.

You can customize the error page to match your site's style and tone.

Always use semantic HTML and accessibility attributes to help all users understand the error.

Summary

Error pages show friendly messages when something goes wrong.

Use +error.svelte in SvelteKit to create custom error pages.

Display the status and error.message to inform users clearly.

Practice

1. What is the main purpose of the +error.svelte file in a SvelteKit project?

easy

A. To handle user authentication

B. To display a custom error page when an error occurs in the app

C. To define global styles for the app

D. To manage routing between pages

Solution

1. Step 1: Understand the role of +error.svelte

   This file is specifically designed to show error messages when something goes wrong in the app.

2. Step 2: Compare with other options

   Authentication, styling, and routing are handled elsewhere, not in +error.svelte.

3. Final Answer:

   To display a custom error page when an error occurs in the app -> Option B

4. Quick Check:

   Error page = +error.svelte [OK]

Hint: Remember: +error.svelte shows errors, not routes or styles [OK]

Common Mistakes:

• Confusing error page with routing or styling files
• Thinking +error.svelte handles authentication
• Assuming it is for normal page content

2. Which of the following is the correct way to access the HTTP status code inside +error.svelte?

easy

A. {error.status}

B. {params.status}

C. {error.message}

D. {status}

Solution

1. Step 1: Recall SvelteKit error props

   In +error.svelte, the status is passed as a separate prop, not inside error.

2. Step 2: Check each option

   {error.status} is incorrect because error holds the error object, but status is separate. {status} is correct. {error.message} is for the message, not status. {params.status} is unrelated.

3. Final Answer:

   {status} -> Option D

4. Quick Check:

   Status code = {status} [OK]

Hint: Status is a separate prop, not inside error object [OK]

Common Mistakes:

• Using {error.status} instead of {status}
• Confusing error message with status code
• Trying to access status from params

3. Given this +error.svelte snippet:

<script>
  export let error;
  export let status;
</script>

<h1>Error {status}</h1>
<p>{error.message}</p>

What will be displayed if status is 404 and error.message is "Page not found"?

medium

A. Error 404Page not found

B. Error Page not found404

C. Error 0undefined

D. Error 404undefined

Solution

1. Step 1: Substitute values in template

   The {status} is 404, so <h1> shows "Error 404". The {error.message} is "Page not found", so <p> shows that text.

2. Step 2: Confirm output matches option

   Error 404
   Page not found matches exactly: "Error 404" and "Page not found". Others have wrong order or undefined values.

3. Final Answer:

   Error 404
   Page not found -> Option A

4. Quick Check:

   Display status and message correctly [OK]

Hint: Match variable names exactly to output text [OK]

Common Mistakes:

• Mixing status and message order
• Assuming undefined values
• Confusing error.message with status

4. You wrote this +error.svelte code:

<script>
  export let error;
</script>

<h1>Error {status}</h1>
<p>{error.message}</p>

But when an error occurs, the page shows Error undefined. What is the problem?

medium

A. You need to import status from another file

B. You should use {error.status} instead of {status}

C. You forgot to export the status prop

D. The error object does not have a message property

Solution

1. Step 1: Identify missing prop export

   The code uses {status} but does not export status from the script, so it is undefined.

2. Step 2: Check other options

   {error.status} is incorrect because status is a separate prop. Importing status is not needed. error.message exists, so that is not the issue.

3. Final Answer:

   You forgot to export the status prop -> Option C

4. Quick Check:

   Export all props used in template [OK]

Hint: Always export props you use in template [OK]

Common Mistakes:

• Using {status} without exporting it
• Trying to access status inside error object
• Assuming error.message is missing

5. You want to create a custom error page that shows a special message for 404 errors and a generic message for others. Which +error.svelte code correctly implements this?

hard

A. <script>
export let error;
export let status;
</script>

<h1>Error {status}</h1>
<p>{status === 404 ? 'Page not found' : error.message}</p>

B. <script>
export let error;
</script>

<h1>Error {error.status}</h1>
<p>{error.message === 404 ? 'Page not found' : error.message}</p>

C. <script>
export let error;
export let status;
</script>

<h1>Error {status}</h1>
<p>{error.message === 404 ? 'Page not found' : error.message}</p>

D. <script>
export let error;
export let status;
</script>

<h1>Error {status}</h1>
<p>{status === '404' ? 'Page not found' : error.message}</p>

Solution

1. Step 1: Check how status is used

   Status is a number, so comparing status === 404 is correct.

   <script>
     export let error;
     export let status;
   </script>
   
   <h1>Error {status}</h1>
   <p>{status === 404 ? 'Page not found' : error.message}</p>

   and D do this, but D compares to string '404' which is wrong.

2. Step 2: Check error.message usage

   <script>
     export let error;
     export let status;
   </script>
   
   <h1>Error {status}</h1>
   <p>{status === 404 ? 'Page not found' : error.message}</p>

   uses error.message as fallback, which is correct. Options B and C incorrectly compare error.message to 404, which makes no sense.

3. Step 3: Confirm correct syntax and logic

   <script>
     export let error;
     export let status;
   </script>
   
   <h1>Error {status}</h1>
   <p>{status === 404 ? 'Page not found' : error.message}</p>

   correctly exports both props and uses a ternary to show special message for 404, else shows error.message.

4. Final Answer:

   Option A code correctly handles 404 and other errors -> Option A

5. Quick Check:

   Compare status number, not error.message [OK]

Hint: Compare status number with 404, not error.message [OK]

Common Mistakes:

• Comparing error.message to 404 instead of status
• Comparing status to string '404' instead of number
• Not exporting both status and error props