Realm JavaScript

Realm.collection

Realm.List 및 Realm.Results 에서 공유하는 메서드를 포함하는 추상 기본 클래스입니다.

Realm collection은 Realm 객체의 속성으로 저장할 수 있는 모든 유형의 값의 동질적인 시퀀스입니다. collection은 첨자, for-of (으)로 열거하는 등 일반 JavaScript 배열에서 할 수 있는 다양한 방법으로 액세스할 수 있습니다.

collection은 항상 Realm의 현재 상태를 반영합니다. 한 가지 예외는 for...in 또는 for...of 열거를 사용하는 경우로, 이는 열거가 시작될 때 일부 객체가 필터에 의해 제외되도록 수정되거나 수정되더라도 항상 쿼리와 일치하는 객체를 열거합니다. 열거형입니다.

이후: 0.11.0

멤버

분량
읽기 전용

collection의 값 수입니다.

유형:
number
옵션
읽기 전용

null 이 collection에 대해 유효한 값인지 여부.

유형:
boolean
이후 버전: 2.0.0
유형
읽기 전용

collection의 값 유형 입니다.

유형:
string
이후 버전: 2.0.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
기호.iterator()Iterator<T>

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

참조: 기호.iterator 와 반복 가능한 프로토콜
Iterator<T> 컬렉션에 있는 각 Realm 객체의 을 반환 합니다.
예:
for (let object of collection) {
  // do something with each object
}
이후: 0.11.0
values()Iterator<T>
참조: Array.prototype.values
Iterator<T> 컬렉션에 있는 각 Realm 객체의 을 반환 합니다.
이후: 0.11.0

유형 정의

이터레이터

ES6 이터레이터입니다.

속성:
  • 다음
    • 유형: function

    • 두 가지 속성을 가진 객체를 반환합니다.

      • done - 반복자가 collection의 항목 전체 반복을 완료한 경우 true , 그렇지 않으면 false
      • value - collection에서 반복되는 다음 항목이거나 done 이 true인 경우 undefined 입니다.
  • 기호.iterator
    • 유형: function

    • 이 메서드는 단순히 this 을 반환하므로 이 반복자 자체를 이터러블(iterator)로 만듭니다(즉, for-of 루프에서 ... 확산 연산자 등과 함께 사용 가능).

참조: 반복자 프로토콜
SortDescriptor

정렬 설명자는 점으로 구분된 하나 이상의 속성 이름을 포함하는 문자열 이거나 [propertyName, reverse] 두 항목이 있는 배열입니다.

유형:
string or Array