기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 기본 제공 유틸리티
<a name="built-in-util-js"></a>

`util` 변수에는 데이터 작업에 도움이 되는 일반 유틸리티 메서드가 포함되어 있습니다. 달리 지정하지 않는 한, 모든 유틸리티는 UTF-8 문자 집합을 사용합니다.

## 인코딩 유틸리티
<a name="utility-helpers-in-encoding"></a>

### 인코딩 유틸리티 목록
<a name="utility-helpers-in-encoding-list-js"></a>

 **`util.urlEncode(String)`**  
입력 문자열을 `application/x-www-form-urlencoded` 인코딩 문자열로 반환합니다.

 **`util.urlDecode(String)`**  
`application/x-www-form-urlencoded` 인코딩 문자열을 인코딩되지 않은 형식으로 다시 디코딩합니다.

**`util.base64Encode(string) : string`**  
입력을 base64 인코딩 문자열로 인코딩합니다.

**`util.base64Decode(string) : string`**  
데이터를 base64 인코딩 문자열에서 디코딩합니다.

## ID 생성 유틸리티
<a name="utility-helpers-in-id-gen-js"></a>

### ID 생성 유틸리티
<a name="utility-helpers-in-id-gen-list-js"></a>

 **`util.autoId()`**  
임의로 생성된 128비트 UUID를 반환합니다.

**`util.autoUlid()`**  
무작위로 생성된 128비트 ULID(Universally Unique Lexicographically Sortable Identifier)를 반환합니다.

**`util.autoKsuid()`**  
길이가 27인 문자열로 인코딩된 무작위로 생성된 128비트 KSUID(K-Sortable Unique Identifier) base62를 반환합니다.

## 오류 유틸리티
<a name="utility-helpers-in-error-js"></a>

### 오류 유틸리티 목록
<a name="utility-helpers-in-error-list-js"></a>

 **`util.error(String, String?, Object?, Object?)`**  
사용자 지정 오류를 발생시킵니다. 이 필드는 요청 또는 응답 매핑 템플릿에서 템플릿이 요청 또는 호출 결과와 관련된 오류를 감지하는 경우 사용할 수 있습니다. 또한 `errorType`, `data` 및 `errorInfo` 필드를 지정할 수 있습니다. GraphQL 응답에서 `data` 값은 `error` 내 해당 `errors` 블록에 추가됩니다.  
참고: `data`는 쿼리 선택 세트를 기반으로 필터링됩니다. GraphQL 응답에서 `errorInfo` 값은 `error` 내 해당 `errors` 블록에 추가됩니다.  
`errorInfo`는 쿼리 선택 세트를 기반으로 필터링되지 **않습니다**.

 **`util.appendError(String, String?, Object?, Object?)`**  
사용자 지정 오류를 추가합니다. 이 필드는 요청 또는 응답 매핑 템플릿에서 템플릿이 요청 또는 호출 결과와 관련된 오류를 감지하는 경우 사용할 수 있습니다. 또한 `errorType`, `data` 및 `errorInfo` 필드를 지정할 수 있습니다. `util.error(String, String?, Object?, Object?)`와 달리 템플릿 평가가 중단되지 않기 때문에 데이터를 호출자에게 반환할 수 있습니다. GraphQL 응답에서 `data` 값은 `error` 내 해당 `errors` 블록에 추가됩니다.  
참고: `data`는 쿼리 선택 세트를 기반으로 필터링됩니다. GraphQL 응답에서 `errorInfo` 값은 `error` 내 해당 `errors` 블록에 추가됩니다.  
`errorInfo`는 쿼리 선택 세트를 기반으로 필터링되지 **않습니다**.

## 유형 및 패턴 매칭 유틸리티
<a name="utility-helpers-in-patterns-js"></a>

### 유형 및 패턴 매칭 유틸리티 목록
<a name="utility-helpers-in-patterns-js-list"></a>

**`util.matches(String, String) : Boolean`**  
첫 번째 인수의 지정된 패턴이 두 번째 인수에서 제공되는 데이터와 일치하는 경우 true를 반환합니다. 패턴은 `util.matches("a*b", "aaaaab")` 등과 같은 정규식이어야 합니다. 이 기능은 [Pattern](https://docs.oracle.com/javase/7/docs/api/java/util/regex/Pattern.html)을 기반으로 하며, 여기서 자세한 설명을 참조할 수 있습니다.

 **`util.authType()`**   
요청에 사용되는 다중 인증 유형을 설명하는 문자열을 반환하고 'IAM 권한 부여', '사용자 풀 권한 부여', 'Open ID Connect 권한 부여' 또는 'API 키 인증'을 반환합니다.

## 반환 값 동작 유틸리티
<a name="utility-helpers-in-cloudwatch-logs-list-js"></a>

### 반환 값 동작 유틸리티 목록
<a name="utility-helpers-in-behavior-list-js"></a>

 **`util.escapeJavaScript(String)`**  
입력 문자열을 JavaScript 의 이스케이프된 문자열로 반환합니다.

## 해석기 권한 부여 유틸리티
<a name="utility-helpers-in-resolver-auth-js"></a>

### 해석기 권한 부여 유틸리티 목록
<a name="utility-helpers-in-resolver-auth-list-js"></a>

 **`util.unauthorized()`**  
해석 중인 필드에 대해 `Unauthorized`를 발생시킵니다. 요청 또는 응답 매핑 템플릿에서 이를 사용하여 호출자가 필드를 확인하도록 허용할지 여부를 결정합니다.