클래스: 결과

기호.iterator()Iterator<T>

이는 values() 메서드와 동일한 메서드입니다. 이 함수가 있으면 collection을 반복 할 수 있으므로 ES6 for-of 루프, ... 분산 연산자 등과 함께 사용할 수 있습니다.

Iterator<T> 컬렉션에 있는 각 Realm 객체의 을 반환 합니다.

예:

for (let object of collection) {
  // do something with each object
}

이후: 0.11.0

addListener(콜백)

라이브 collection 인스턴스가 변경될 때 호출될 리스너 callback 를 추가합니다.

매개변수:

콜백

유형: function
변경 사항이 발생할 때 호출되는 함수입니다. 콜백 함수는 두 개의 인수를 사용하여 호출됩니다.
- collection: 변경된 collection 인스턴스,
- changes: insertions, newModifications, oldModifications 및 deletions 키가 있는 딕셔너리로, 각각 collection에서 삽입, 업데이트 또는 삭제된 인덱스 목록을 포함합니다. deletions 및 oldModifications 는 변경이 발생하기 전의 collection에 대한 인덱스이고, insertions 및 newModifications 는 새 버전의 collection에 대한 인덱스입니다.

예외 처리:

Error
- callback 가 함수가 아닌 경우.

예:

wines.addListener((collection, changes) => {
 // collection === wines
 console.log(`${changes.insertions.length} insertions`);
 console.log(`${changes.modifications.length} modifications`);
 console.log(`${changes.deletions.length} deletions`);
 console.log(`new size of collection: ${collection.length}`);
});

평균(속성)number

컬렉션에 있는 모든 객체 중 컬렉션 또는 지정된 속성의 값의 평균을 계산하거나, 컬렉션이 비어 있는 경우 undefined 를 계산합니다.

int, float 및 double 속성에 대해서만 지원됩니다. 이 메서드에서는 null 값은 완전히 무시되며 평균에 포함되지 않습니다.

매개변수:

속성 옵션

유형: string
객체의 collection, 평균을 구할 속성입니다.

예외 처리:

Error
- 해당 이름을 가진 속성이 없거나 속성이 숫자가 아닌 경우입니다.

반환 값: number 합계.

이후 버전: 1.12.1

항목()Iterator<T>

참조: Array.prototype.entries

반환 값: collection에 있는 각 [index, object] 쌍의 Iterator<T>

이후: 0.11.0

매(콜백, thisArg)boolean

참조: Array.prototype.every

매개변수:

콜백

유형: function
collection의 각 객체에 대해 실행할 함수입니다. 이 함수가 모든 객체에 대해 true 을 반환하면 이 메서드는 true 을 반환합니다. 이 함수는 세 개의 인수를 사용합니다:
- object - collection에서 처리 중인 현재 객체입니다.
- index - collection에서 처리 중인 객체의 인덱스입니다.
- collection - collection 자체.

thisArg 옵션

유형: object
callback 이(가) 호출될 때의 this 값입니다.

반환 값: boolean 은(는 callback 이(가) collection의 모든 객체에 대해 true 을(를) 반환했는지 여부를 나타냅니다.

이후: 0.11.0

필터링됨쿼리, arg)Realm.Results<T>

제공된 query로 필터링되는 이 collection을 나타내는 새 결과 를 반환합니다.

매개변수:

쿼리

유형: string
컬렉션에서 객체를 필터링하는 데 사용되는 쿼리입니다.

arg 옵션 반복 가능

유형: any
각 후속 인수는 자리 표시자에 의해 사용됩니다(예: $0, $1, $2, ...).

예외 처리:

Error
- 이 메서드로 전달된 쿼리 또는 기타 인수가 유효하지 않은 경우입니다.

반환값: 제공된 쿼리에 따라 필터링된 Realm.Results<T> . 이 기능은 현재 Realm 객체 collection에만 지원됩니다. 쿼리 언어 에 대한 자세한 내용은 쿼리 언어를 참조하세요.

예:

let merlots = wines.filtered('variety == "Merlot" && vintage

찾기(콜백, thisArg)T or undefined

참조: Array.prototype.find

매개변수:

콜백

유형: function
collection의 각 객체에 대해 실행할 함수입니다. 이 함수가 true 을 반환하면 해당 객체가 이 메서드에 의해 반환됩니다. 이 함수는 세 개의 인수를 사용합니다:
- object - collection에서 처리 중인 현재 객체입니다.
- index - collection에서 처리 중인 객체의 인덱스입니다.
- collection - collection 자체.

thisArg 옵션

유형: object
callback 이(가) 호출될 때의 this 값입니다.

반환 값: T 또는 undefined 이 collection의 객체에 대해 을 반환하지 callback true 않은 경우 .

이후: 0.11.0

findIndex(콜백, thisArg)number

참조: Array.prototype.findIndex

매개변수:

콜백

유형: function
collection의 각 객체에 대해 실행할 함수입니다. 이 함수가 true 을 반환하면 이 메서드는 해당 객체의 인덱스를 반환합니다. 이 함수는 세 개의 인수를 사용합니다:
- object - collection에서 처리 중인 현재 객체입니다.
- index - collection에서 처리 중인 객체의 인덱스입니다.
- collection - collection 자체.

thisArg 옵션

유형: object
callback 이(가) 호출될 때의 this 값입니다.

number callback true -1 true 반환값: 가 을 반환한 인덱스를 나타내는 , 또는 가 반환되지 않은 경우 를 반환합니다.

이후: 0.11.0

forEach(콜백, thisArg)

참조: Array.prototype.forEach

매개변수:

콜백

유형: function
collection의 각 객체에 대해 실행할 함수입니다. 이 함수는 세 개의 인수를 사용합니다:
- object - collection에서 처리 중인 현재 객체입니다.
- index - collection에서 처리 중인 객체의 인덱스입니다.
- collection - collection 자체.

thisArg 옵션

유형: object
callback 이(가) 호출될 때의 this 값입니다.

이후: 0.11.0

indexOf(객체)number

collection에서 지정된 객체의 인덱스를 찾습니다.

매개변수:

객체

유형: T
collection에서 검색 값입니다.

예외 처리:

Error
- 인수가 collection과 동일한 Realm에 속하지 않는 Realm.Object 인 경우.

반환 값: 값이 발견된 인덱스를 나타내는 number , 또는 collection에 없는 경우 -1 .

이후 버전: 1.8.2

isEmpty()boolean

이 collection이 비어 있는지 확인합니다.

반환 값: collection이 비어 있는지 여부를 나타내는 boolean 을(를) 반환합니다.

이후 버전: 2.7.0

isValid()boolean

이 collection이 삭제되지 않았으며 유효한 Realm의 일부인지 확인합니다.

반환 값: collection에 안전하게 액세스할 수 있는지 여부를 나타내는 boolean .

이후 버전: 0.14.0

가입(구분 기호)string

collection의 모든 객체를 문자열로 결합합니다.

참조: Array.prototype.join

매개변수:

구분 기호 옵션

유형: string
기본값입니다: ","
collection의 각 객체에 대해 호출되는 toString() 메서드의 반환 값을 구분하는 문자열입니다.

반환값: string

이후: 0.11.0

키()Iterator<T>

참조: Array.prototype.keys

반환 값: collection에 있는 각 인덱스의 Iterator<T>

이후: 0.11.0

map(콜백, thisArg)[any, ...]

참조: Array.prototype.map

매개변수:

콜백

유형: function
collection의 각 객체에 대해 실행할 함수입니다. 이 함수는 세 개의 인수를 사용합니다:
- object - collection에서 처리 중인 현재 객체입니다.
- index - collection에서 처리 중인 객체의 인덱스입니다.
- collection - collection 자체.

thisArg 옵션

유형: object
callback 이(가) 호출될 때의 this 값입니다.

반환 값: [any, ...] - collection의 모든 객체에 대해 호출된 후 callback 의 값을 반환합니다.

이후: 0.11.0

최대(속성)number

컬렉션에 있는 값 또는 컬렉션에 있는 모든 객체 중 지정된 속성의 최대값을 반환하거나, 컬렉션이 비어 있는 경우 undefined 를 반환합니다.

int, float, double 및 날짜 속성에 대해서만 지원됩니다. null 값은 이 메서드에서 완전히 무시되며 반환되지 않습니다.

매개변수:

속성 옵션

유형: string
객체 collection의 경우 최대로 사용할 속성입니다.

예외 처리:

Error
- 해당 이름의 속성이 없거나 속성이 숫자/날짜가 아닌 경우.

반환 값: number 최대값.

이후 버전: 1.12.1

min(속성)number

컬렉션에 있는 값 또는 컬렉션에 있는 모든 객체 중 지정된 속성의 최소값을 반환하거나, 컬렉션이 비어 있는 경우 undefined 를 반환합니다.

int, float, double 및 날짜 속성에 대해서만 지원됩니다. null 값은 이 메서드에서 완전히 무시되며 반환되지 않습니다.

매개변수:

속성 옵션

유형: string
객체 collection의 경우 최소값을 취할 속성입니다.

예외 처리:

Error
- 해당 이름의 속성이 없거나 속성이 숫자/날짜가 아닌 경우.

반환 값: number 최소값.

이후 버전: 1.12.1

reduce(콜백, 초기 값)any

참조: Array.prototype.reduce

매개변수:

콜백

유형: function
collection의 각 객체에 대해 실행할 함수입니다. 이 함수는 네 개의 인수를 사용합니다:
- previousValue - 콜백의 마지막 호출에서 이전에 반환된 값 또는 initialValue(제공된 경우)입니다.
- object - collection에서 처리 중인 현재 객체입니다.
- index - collection에서 처리 중인 객체의 인덱스입니다.
- collection - collection 자체.

초기 값 옵션

유형: object
callback 의 첫 번째 호출에 대한 첫 번째 인수로 사용할 값입니다.

예외 처리:

TypeError
- collection이 비어 있고 initialValue 이 제공되지 않은 경우입니다.

반환 값: any - 다음과 같은 특수한 경우를 제외하고 , callback 의 최종 호출에서 반환된 값입니다.

collection이 단일 객체로 구성되어 있고 initalValue 이 제공되지 않은 경우 해당 객체가 반환됩니다.
collection이 비어 있으면 initialValue 를 제공 해야 하며 이 반환됩니다.

이후: 0.11.0

reduceRright(콜백, 초기 값)any

참조: Array.prototype.reduceRright

매개변수:

콜백

유형: function
collection의 각 객체에서 오른쪽에서 왼쪽 으로 실행할 함수입니다. 이 함수는 네 개의 인수를 사용합니다:
- previousValue - 콜백의 마지막 호출에서 이전에 반환된 값 또는 initialValue(제공된 경우)입니다.
- object - collection에서 처리 중인 현재 객체입니다.
- index - collection에서 처리 중인 객체의 인덱스입니다.
- collection - collection 자체.

초기 값 옵션

유형: object
callback 의 첫 번째 호출에 대한 첫 번째 인수로 사용할 값입니다.

예외 처리:

TypeError
- collection이 비어 있고 initialValue 이 제공되지 않은 경우입니다.

반환 값: any - 다음과 같은 특수한 경우를 제외하고 , callback 의 최종 호출에서 반환된 값입니다.

collection이 단일 객체로 구성되어 있고 initalValue 이 제공되지 않은 경우 해당 객체가 반환됩니다.
collection이 비어 있으면 initialValue 를 제공 해야 하며 이 반환됩니다.

이후: 0.11.0

removeAllListeners()

collection 인스턴스에서 모든 callback 리스너를 제거합니다.

removeListener(콜백)

collection 인스턴스에서 callback 리스너를 제거합니다.

매개변수:

콜백

유형: function
이전에 addListener 메서드를 통해 리스너로 추가된 콜백 함수입니다.

예외 처리:

Error
- callback 가 함수가 아닌 경우.

슬라이스(시작, 종료)[T, ...]

참조: Array.prototype.slice

매개변수:

시작하기 옵션

유형: number
기본값입니다: 0
시작 인덱스입니다. 음수인 경우 시작 인덱스는 collection이 끝난 시점부터 계산됩니다.

end 옵션

유형: number
종료 인덱스입니다. 마지막 인덱스를 포함하지 않는 객체도 반환 값에 포함됩니다. 음수인 경우 최종 인덱스는 collection의 끝부터 계산됩니다. 생략하면 시작 인덱스의 모든 객체가 반환 값에 포함됩니다.

반환값: 시작 인덱스부터 종료 인덱스까지의 객체를 포함하는 [T, ...] 포함하지 않음).

이후: 0.11.0

스냅샷()Realm.Results<T>

collection의 스냅샷을 만듭니다.

원래 collection에 추가되거나 제거된 값은 적용된 필터와 일치하도록 속성 값을 변경한 경우를 포함하여 이 메서드가 반환하는 결과 에 반영되지 않습니다.

이 스냅샷은 깊은 스냅샷이 아닙니다 . 이 스냅샷에 포함된 Realm 객체는 변경 사항이 적용되더라도 계속 업데이트되며, Realm에서 삭제되면 해당 인덱스에서 null (으)로 대체됩니다.

예외 처리:

Error
- 기본 유형의 collection 스냅샷을 만들 때.

실시간 업데이트가 Realm.Results<T> 아닌 을(를) 반환 합니다.

some(콜백, thisArg)boolean

참조: Array.prototype. 일부

매개변수:

콜백

유형: function
collection의 각 객체에 대해 실행할 함수입니다. 이 함수가 true 을 반환하면 이 메서드는 true 을 반환합니다. 이 함수는 세 개의 인수를 사용합니다:
- object - collection에서 처리 중인 현재 객체입니다.
- index - collection에서 처리 중인 객체의 인덱스입니다.
- collection - collection 자체.

thisArg 옵션

유형: object
callback 이(가) 호출될 때의 this 값입니다.

반환 값: 이 collection의 객체에 대해 를 반환하는 경우 boolean true - , 그렇지 callback true false않으면 .

이후: 0.11.0

정렬됨(디스크립터, reverse)Realm.Results<T>

이 collection의 정렬된 보기를 나타내는 새 결과 를 반환합니다.

Realm 객체 collection은 해당 객체의 하나 이상의 속성 또는 해당 객체에 연결된 객체의 속성을 기준으로 정렬될 수 있습니다. 단일 속성을 기준으로 정렬하려면 해당 속성의 이름을 sorted() 에 전달하고 선택적으로 정렬을 되돌릴지 여부를 나타내는 부울을 뒤에 붙입니다. 둘 이상의 속성에 대해 정렬할 속성을 나열하는 정렬 설명자 배열을 전달해야 합니다.

다른 유형의 컬렉션은 값의 속성이 아닌 값 자체를 기준으로 정렬하므로 속성 이름이나 정렬 설명자를 제공해서는 안 됩니다.

매개변수:

디스크립터 옵션

유형: string 또는 [SortDescriptor, ...]
collection을 정렬할 속성 이름입니다.

reverse 옵션

유형: boolean
기본값입니다: false
오름차순이 아닌 내림차순으로 정렬합니다. descriptor 이(가) 정렬 설명자의 배열인 경우 제공되지 않을 수 있습니다.

예외 처리:

Error
- 지정된 속성이 존재하지 않는 경우.

반환값: Realm.Results<T> 전달된 인수에 따라 정렬됩니다.

예시:

// Sort wines by age
wines.sorted('age')

// Sort wines by price in descending order, then sort ties by age in
// ascending order
wines.sorted([['price', false], ['age']])

// Sort a list of numbers in ascending order
let sortedPrices = wine.pricesSeen.sort()

// Sort people by how expensive their favorite wine is
people.sort("favoriteWine.price")

합계(속성)number

컬렉션의 모든 객체 중 지정된 속성 또는 컬렉션의 값의 합계를 계산하거나, 컬렉션이 비어 있으면 0을 계산합니다.

int, float 및 double 속성에 대해서만 지원됩니다. 이 메서드에서는 null 값을 완전히 무시합니다.

매개변수:

속성 옵션

유형: string
객체의 collection, 합계를 구할 속성입니다.

예외 처리:

Error
- 해당 이름을 가진 속성이 없거나 속성이 숫자가 아닌 경우입니다.

반환 값: number 합계.

이후 버전: 1.12.1

values()Iterator<T>

참조: Array.prototype.values

Iterator<T> 컬렉션에 있는 각 Realm 객체의 을 반환 합니다.

이후: 0.11.0

확장

멤버

유형:

유형:

유형:

방법

매개변수:

예외 처리:

상속된 메서드

예:

매개변수:

예외 처리:

예:

매개변수:

예외 처리:

매개변수:

매개변수:

예외 처리:

예:

매개변수:

매개변수:

매개변수:

매개변수:

예외 처리:

매개변수:

매개변수:

매개변수:

예외 처리:

매개변수:

예외 처리:

매개변수:

예외 처리:

매개변수:

예외 처리:

매개변수:

예외 처리:

매개변수:

예외 처리:

매개변수:

매개변수:

예외 처리:

예시:

매개변수:

예외 처리: