From c909680824ad4aeda03313cfc399bf35ae9b37c4 Mon Sep 17 00:00:00 2001 From: Junyu Wei Date: Tue, 31 Dec 2024 15:58:17 +0800 Subject: [PATCH] Update CJK docs for groupby --- .tool-versions | 1 + docs/ja/reference/array/groupBy.md | 22 ++++++++++++++-------- docs/ko/reference/array/groupBy.md | 22 ++++++++++++++-------- docs/zh_hans/reference/array/groupBy.md | 20 +++++++++++++------- 4 files changed, 42 insertions(+), 23 deletions(-) create mode 100644 .tool-versions diff --git a/.tool-versions b/.tool-versions new file mode 100644 index 000000000..acb1cd068 --- /dev/null +++ b/.tool-versions @@ -0,0 +1 @@ +nodejs 22.12.0 \ No newline at end of file diff --git a/docs/ja/reference/array/groupBy.md b/docs/ja/reference/array/groupBy.md index c346bad30..e2034c365 100644 --- a/docs/ja/reference/array/groupBy.md +++ b/docs/ja/reference/array/groupBy.md @@ -1,20 +1,20 @@ # groupBy -与えられたキー生成関数に従って配列の要素を分類します。 +与えられたキー生成関数またはプロパティキーに従って配列の要素を分類します。 -この関数は、配列と各要素からキーを生成する関数をパラメータとして受け取ります。 -キーは関数で生成されたキーであり、値はそのキーを共有する要素をグループ化した配列であるオブジェクトを返します。 +この関数は、配列と各要素からキーを生成する関数、またはプロパティキー文字列をパラメータとして受け取ります。 +キーは関数で生成されたキーまたはプロパティキーであり、値はそのキーを共有する要素をグループ化した配列であるオブジェクトを返します。 ## インターフェース ```typescript -function groupBy(arr: T[], getKeyFromItem: (item: T) => K): Record; +function groupBy(arr: readonly T[], keyOrFn: ((item: T) => K) | keyof T): Record; ``` ### パラメータ -- `arr` (`T[]`): 要素を分類する配列。 -- `getKeyFromItem` (`(item: T) => K`): 要素からキーを生成する関数。 +- `arr` (`readonly T[]`): 要素を分類する配列。 +- `keyOrFn` (`((item: T) => K) | keyof T`): 要素からキーを生成する関数、またはグループ化するプロパティのキー。 ### 戻り値 @@ -28,8 +28,14 @@ const array = [ { category: 'fruit', name: 'banana' }, { category: 'vegetable', name: 'carrot' }, ]; -const result = groupBy(array, item => item.category); -// 結果: + +// キー生成関数を使用する場合: +const result1 = groupBy(array, item => item.category); + +// プロパティキーを使用する場合: +const result2 = groupBy(array, 'category'); + +// どちらも同じ結果になります: // { // fruit: [ // { category: 'fruit', name: 'apple' }, diff --git a/docs/ko/reference/array/groupBy.md b/docs/ko/reference/array/groupBy.md index d9685213e..8189d6fed 100644 --- a/docs/ko/reference/array/groupBy.md +++ b/docs/ko/reference/array/groupBy.md @@ -1,20 +1,20 @@ # groupBy -주어진 키 생성 함수에 따라서 배열의 요소를 분류해요. +주어진 키 생성 함수 또는 프로퍼티 키에 따라서 배열의 요소를 분류해요. -이 함수는 파라미터로 배열과 각 요소에서 키를 생성하는 함수를 받아요. -키는 함수에서 생성된 키이고, 값은 그 키를 공유하는 요소끼리 묶은 배열인 객체를 반환해요. +이 함수는 파라미터로 배열과 각 요소에서 키를 생성하는 함수 또는 프로퍼티 키 문자열을 받아요. +키는 함수에서 생성된 키 또는 프로퍼티 키이고, 값은 그 키를 공유하는 요소끼리 묶은 배열인 객체를 반환해요. ## 인터페이스 ```typescript -function groupBy(arr: T[], getKeyFromItem: (item: T) => K): Record; +function groupBy(arr: readonly T[], keyOrFn: ((item: T) => K) | keyof T): Record; ``` ### 파라미터 -- `arr` (`T[]`): 요소를 분류할 배열. -- `getKeyFromItem` (`(item: T) => K`): 요소에서 키를 생성하는 함수. +- `arr` (`readonly T[]`): 요소를 분류할 배열. +- `keyOrFn` (`((item: T) => K) | keyof T`): 요소에서 키를 생성하는 함수 또는 그룹화할 프로퍼티의 키. ### 반환 값 @@ -28,8 +28,14 @@ const array = [ { category: 'fruit', name: 'banana' }, { category: 'vegetable', name: 'carrot' }, ]; -const result = groupBy(array, item => item.category); -// 결괏값: + +// 키 생성 함수를 사용하는 경우: +const result1 = groupBy(array, item => item.category); + +// 프로퍼티 키를 사용하는 경우: +const result2 = groupBy(array, 'category'); + +// 둘 다 같은 결과가 나와요: // { // fruit: [ // { category: 'fruit', name: 'apple' }, diff --git a/docs/zh_hans/reference/array/groupBy.md b/docs/zh_hans/reference/array/groupBy.md index 47dedbe7f..153910ec5 100644 --- a/docs/zh_hans/reference/array/groupBy.md +++ b/docs/zh_hans/reference/array/groupBy.md @@ -1,19 +1,19 @@ # groupBy -将数组的元素根据提供的键生成函数进行分组。 +将数组的元素根据提供的键生成函数或属性键进行分组。 -该函数接受一个数组和一个从每个元素生成键的函数。它返回一个对象，其中键是生成的键，值是具有相同键的元素数组。 +该函数接受一个数组和一个从每个元素生成键的函数或属性键字符串。它返回一个对象，其中键是生成的键或属性键，值是具有相同键的元素数组。 ## 签名 ```typescript -function groupBy(arr: T[], getKeyFromItem: (item: T) => K): Record; +function groupBy(arr: readonly T[], keyOrFn: ((item: T) => K) | keyof T): Record; ``` ### 参数 -- `arr` (`T[]`): 要分组的数组。 -- `getKeyFromItem` (`(item: T) => K`): 从元素生成键的函数。 +- `arr` (`readonly T[]`): 要分组的数组。 +- `keyOrFn` (`((item: T) => K) | keyof T`): 从元素生成键的函数或用于分组的属性键。 ### 返回值 @@ -27,8 +27,14 @@ const array = [ { category: 'fruit', name: 'banana' }, { category: 'vegetable', name: 'carrot' }, ]; -const result = groupBy(array, item => item.category); -// 结果将是: + +// 使用键生成函数： +const result1 = groupBy(array, item => item.category); + +// 使用属性键： +const result2 = groupBy(array, 'category'); + +// 两种方式得到相同的结果： // { // fruit: [ // { category: 'fruit', name: 'apple' },