Skip to content

Commit

Permalink
[#31] docs: custom-error 번역 (#50)
Browse files Browse the repository at this point in the history
* [#31] docs: custom-error 번역
* [#31] style: prettier 적용
  • Loading branch information
imdaxsz authored Jul 31, 2024
1 parent d4d253a commit f6325d7
Showing 1 changed file with 14 additions and 16 deletions.
30 changes: 14 additions & 16 deletions pages/docs/pages/building-your-application/routing/custom-error.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,47 +3,45 @@ title: Custom Errors
description: Override and extend the built-in Error page to handle custom errors.
---

{/* TODO: 번역이 필요합니다. */}

# Custom Errors

## 404 Page

A 404 page may be accessed very often. Server-rendering an error page for every visit increases the load of the Next.js server. This can result in increased costs and slow experiences.
404 페이지는 자주 접근될 수 있습니다. 방문할 때마다 서버에서 에러 페이지를 렌더링하면 Next.js 서버의 부하가 증가합니다. 이는 비용 증가와 느린 사용자 경험으로 이어질 수 있습니다.

To avoid the above pitfalls, Next.js provides a static 404 page by default without having to add any additional files.
이러한 문제를 피하기 위해, Next.js는 추가 파일 없이 기본적으로 정적 404 페이지를 제공합니다.

### Customizing The 404 Page

To create a custom 404 page you can create a `pages/404.js` file. This file is statically generated at build time.
커스텀 404 페이지를 만들려면 `pages/404.js` 파일을 만들면 됩니다. 이 파일은 빌드 시 정적으로 생성됩니다.

```jsx filename="pages/404.js"
export default function Custom404() {
return <h1>404 - Page Not Found</h1>
}
```

> **Good to know**: You can use [`getStaticProps`](/docs/pages/building-your-application/data-fetching/get-static-props) inside this page if you need to fetch data at build time.
> **알아두면 좋은 점**: 빌드 시 데이터를 가져와야 하는 경우 이 페이지 내에서 [`getStaticProps`](/docs/pages/building-your-application/data-fetching/get-static-props)를 사용할 수 있습니다.
## 500 Page

Server-rendering an error page for every visit adds complexity to responding to errors. To help users get responses to errors as fast as possible, Next.js provides a static 500 page by default without having to add any additional files.
방문할 때마다 오류 페이지를 서버에서 렌더링하면 오류에 대한 응답이 복잡해집니다. 사용자가 최대한 빠르게 오류에 대한 응답을 받을 수 있도록 Next.js는 추가 파일 없이 기본적으로 정적 500 페이지를 제공합니다.

### Customizing The 500 Page

To customize the 500 page you can create a `pages/500.js` file. This file is statically generated at build time.
500 페이지를 사용자 정의하려면 `pages/500.js` 파일을 만들면 됩니다. 이 파일은 빌드 시 정적으로 생성됩니다.

```jsx filename="pages/500.js"
export default function Custom500() {
return <h1>500 - Server-side error occurred</h1>
}
```

> **Good to know**: You can use [`getStaticProps`](/docs/pages/building-your-application/data-fetching/get-static-props) inside this page if you need to fetch data at build time.
> **알아두면 좋은 점**: 빌드 시 데이터를 가져와야 하는 경우 이 페이지 내에서 [`getStaticProps`](/docs/pages/building-your-application/data-fetching/get-static-props)를 사용할 수 있습니다.
### More Advanced Error Page Customizing

500 errors are handled both client-side and server-side by the `Error` component. If you wish to override it, define the file `pages/_error.js` and add the following code:
500 오류는 클라이언트 측과 서버 측에서 모두 `Error` 컴포넌트에 의해 처리됩니다. 이를 재정의하려면 `pages/_error.js` 파일을 정의하고 다음 코드를 추가하세요:

```jsx
function Error({ statusCode }) {
Expand All @@ -64,11 +62,11 @@ Error.getInitialProps = ({ res, err }) => {
export default Error
```

> `pages/_error.js` is only used in production. In development you’ll get an error with the call stack to know where the error originated from.
> `pages/_error.js`는 프로덕션에서만 사용됩니다. 개발 환경에서는 오류가 발생한 위치를 알 수 있도록 콜 스택과 함께 오류가 표시됩니다.
### Reusing the built-in error page

If you want to render the built-in error page you can by importing the `Error` component:
기본 내장된 오류 페이지를 렌더링하려면 `Error` 컴포넌트를 가져와 사용할 수 있습니다:

```jsx
import Error from 'next/error'
Expand All @@ -92,11 +90,11 @@ export default function Page({ errorCode, stars }) {
}
```

The `Error` component also takes `title` as a property if you want to pass in a text message along with a `statusCode`.
`Error` 컴포넌트는 `statusCode`와 함께 텍스트 메시지를 전달하려는 경우 `title`을 프로퍼티로 받을 수 있습니다.

If you have a custom `Error` component be sure to import that one instead. `next/error` exports the default component used by Next.js.
커스텀 `Error` 컴포넌트가 있는 경우 해당 컴포넌트를 가져와 사용해야 합니다. `next/error`는 Next.js에서 사용하는 기본 컴포넌트를 내보냅니다.

### Caveats

- `Error` does not currently support Next.js [Data Fetching methods](/docs/pages/building-your-application/data-fetching) like [`getStaticProps`](/docs/pages/building-your-application/data-fetching/get-static-props) or [`getServerSideProps`](/docs/pages/building-your-application/data-fetching/get-server-side-props).
- `_error`, like `_app`, is a reserved pathname. `_error` is used to define the customized layouts and behaviors of the error pages. `/_error` will render 404 when accessed directly via [routing](/docs/pages/building-your-application/routing) or rendering in a [custom server](/docs/pages/building-your-application/configuring/custom-server).
- `Error`는 현재 [`getStaticProps`](/docs/pages/building-your-application/data-Fetching/get-static-props)[`getServerSideProps`](/docs/pages/building-your-application/data-fetching/get-server-side-props)와 같은 Next.js [Data Fetching methods](/docs/pages/building-your-application/data-fetching)를 지원하지 않습니다.
- `_error``_app`과 마찬가지로 예약된 경로명입니다. `_error`는 오류 페이지의 사용자 정의된 레이아웃과 동작을 정의하는 데 사용됩니다. `/_error`[routing](/docs/pages/building-your-application/routing)을 통해 직접 접근하거나 [custom server](/docs/pages/building-your-application/configuring/custom-server)에서 렌더링할 경우 404를 렌더링합니다.

0 comments on commit f6325d7

Please sign in to comment.