Realm.설정

유형이 "Set" 인 객체 속성에 액세스할 때 이 클래스의 인스턴스가 반환됩니다( ObjectSchemaProperty 참조).

세트는 대부분 일반 JavaScript 세트처럼 동작하지만 몇 가지 예외가 있습니다. 즉, 단일 유형의 값만 저장할 수 있습니다(세트의 typeoptional 속성으로 표시됨). 쓰기 트랜잭션 (write transaction) 내에서만 수정할 수 있습니다. JavaScript의 Set과 달리 Realm~Set는 values(), entries(), keys() 또는 forEach 반복의 순회 순서를 보장하지 않습니다. 세트의 값에 특정 순서가 필요한 경우, 예를 들어 개발자가 사용자가 제공한 삽입 순서를 보유하는 객체에 값을 래핑하는 방식으로 구현해야 합니다.

분량
읽기 전용

collection의 값 수입니다.

유형:
number
옵션
읽기 전용

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

유형:
boolean
유형
읽기 전용

collection의 값 유형 입니다.

유형:
string
추가(값)Realm.Set

세트에 값 추가

매개변수:
  • value
    • 유형: T
    • 세트에 추가할 값

예외 처리:
  • TypeError
    • value 가 세트에 저장할 수 있는 유형이 아니거나 세트에 추가되는 객체가 세트의 object schema 와(과) 일치하지 않는 경우입니다.

  • Error
    • 쓰기 트랜잭션(write transaction) 내부가 아닌 경우.

반환값: Realm.Set : 요소를 추가한 후의 세트 자체
지우기()void

세트에서 모든 값 제거

예외 처리:
  • Error
    • 쓰기 트랜잭션(write transaction) 내부가 아닌 경우.

반환값: void
삭제(값)boolean

세트에서 값 제거

매개변수:
  • value
    • 유형: T
    • 세트에서 삭제할 값

예외 처리:
  • Error
    • 쓰기 트랜잭션(write transaction) 내부가 아닌 경우.

반환 값: boolean : 값이 세트에 존재하면 true, 그렇지 않으면 false를 반환합니다.
has(값)boolean

세트에 값이 있는지 확인합니다.

매개변수:
  • value
    • 유형: T
    • 세트에서 검색할 값

예외 처리:
  • TypeError
    • value 가 세트에 저장할 수 있는 유형이 아니거나 세트에 추가되는 객체가 세트의 object schema 와(과) 일치하지 않는 경우입니다.

반환 값: boolean : 값이 세트에 있으면 참, 그렇지 않으면 거짓
기호.iterator()Iterator<T>

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

Iterator<T> 컬렉션에 있는 각 Realm 객체의 을 반환 합니다.
:
for (let object of collection) {
  // do something with each object
}
addListener(콜백)

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

매개변수:
  • 콜백
    • 유형: function
    • 변경 사항이 발생할 때 호출되는 함수입니다. 콜백 함수는 두 개의 인수를 사용하여 호출됩니다.

      • collection: 변경된 collection 인스턴스,
      • changes: insertions, newModifications, oldModificationsdeletions 키가 있는 딕셔너리로, 각각 collection에서 삽입, 업데이트 또는 삭제된 인덱스 목록을 포함합니다. deletionsoldModifications 는 변경이 발생하기 전의 collection에 대한 인덱스이고, insertionsnewModifications 는 새 버전의 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 합계.
항목()Iterator<T>
반환 값: collection에 있는 각 [index, object] 쌍의 Iterator<T>
(콜백, thisArg)boolean
매개변수:
  • 콜백
    • 유형: function
    • collection의 각 객체에 대해 실행할 함수입니다. 이 함수가 모든 객체에 대해 true 을 반환하면 이 메서드는 true 을 반환합니다. 이 함수는 세 개의 인수를 사용합니다:

      • object - collection에서 처리 중인 현재 객체입니다.
      • index - collection에서 처리 중인 객체의 인덱스입니다.
      • collection - collection 자체.
  • thisArg 옵션
    • 유형: object
    • callback 이(가) 호출될 때의 this 값입니다.

반환 값: boolean 은(는 callback 이(가) collection의 모든 객체에 대해 true 을(를) 반환했는지 여부를 나타냅니다.
필터링됨쿼리, 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
매개변수:
  • 콜백
    • 유형: function
    • collection의 각 객체에 대해 실행할 함수입니다. 이 함수가 true 을 반환하면 해당 객체가 이 메서드에 의해 반환됩니다. 이 함수는 세 개의 인수를 사용합니다:

      • object - collection에서 처리 중인 현재 객체입니다.
      • index - collection에서 처리 중인 객체의 인덱스입니다.
      • collection - collection 자체.
  • thisArg 옵션
    • 유형: object
    • callback 이(가) 호출될 때의 this 값입니다.

반환 값: T 또는 undefined 이 collection의 객체에 대해 을 반환하지 callback true 않은 경우 .
findIndex(콜백, thisArg)number
매개변수:
  • 콜백
    • 유형: function
    • collection의 각 객체에 대해 실행할 함수입니다. 이 함수가 true 을 반환하면 이 메서드는 해당 객체의 인덱스를 반환합니다. 이 함수는 세 개의 인수를 사용합니다:

      • object - collection에서 처리 중인 현재 객체입니다.
      • index - collection에서 처리 중인 객체의 인덱스입니다.
      • collection - collection 자체.
  • thisArg 옵션
    • 유형: object
    • callback 이(가) 호출될 때의 this 값입니다.

number callback true -1 true 반환값: 가 을 반환한 인덱스를 나타내는 , 또는 가 반환되지 않은 경우 를 반환합니다.
forEach(콜백, thisArg)
매개변수:
  • 콜백
    • 유형: function
    • collection의 각 객체에 대해 실행할 함수입니다. 이 함수는 세 개의 인수를 사용합니다:

      • object - collection에서 처리 중인 현재 객체입니다.
      • index - collection에서 처리 중인 객체의 인덱스입니다.
      • collection - collection 자체.
  • thisArg 옵션
    • 유형: object
    • callback 이(가) 호출될 때의 this 값입니다.

indexOf(객체)number

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

매개변수:
  • 객체
    • 유형: T
    • collection에서 검색 값입니다.

예외 처리:
  • Error
    • 인수가 collection과 동일한 Realm에 속하지 않는 Realm.Object 인 경우.

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

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

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

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

반환 값: collection에 안전하게 액세스할 수 있는지 여부를 나타내는 boolean .
가입(구분 기호)string

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

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

반환값: string
()Iterator<T>
반환 값: collection에 있는 각 인덱스의 Iterator<T>
map(콜백, thisArg)[any, ...]
매개변수:
  • 콜백
    • 유형: function
    • collection의 각 객체에 대해 실행할 함수입니다. 이 함수는 세 개의 인수를 사용합니다:

      • object - collection에서 처리 중인 현재 객체입니다.
      • index - collection에서 처리 중인 객체의 인덱스입니다.
      • collection - collection 자체.
  • thisArg 옵션
    • 유형: object
    • callback 이(가) 호출될 때의 this 값입니다.

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

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

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

매개변수:
  • 속성 옵션
    • 유형: string
    • 객체 collection의 경우 최대로 사용할 속성입니다.

예외 처리:
  • Error
    • 해당 이름의 속성이 없거나 속성이 숫자/날짜가 아닌 경우.

반환 값: number 최대값.
min(속성)number

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

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

매개변수:
  • 속성 옵션
    • 유형: string
    • 객체 collection의 경우 최소값을 취할 속성입니다.

예외 처리:
  • Error
    • 해당 이름의 속성이 없거나 속성이 숫자/날짜가 아닌 경우.

반환 값: number 최소값.
reduce(콜백, 초기 값)any
매개변수:
  • 콜백
    • 유형: function
    • collection의 각 객체에 대해 실행할 함수입니다. 이 함수는 네 개의 인수를 사용합니다:

      • previousValue - 콜백의 마지막 호출에서 이전에 반환된 값 또는 initialValue(제공된 경우)입니다.
      • object - collection에서 처리 중인 현재 객체입니다.
      • index - collection에서 처리 중인 객체의 인덱스입니다.
      • collection - collection 자체.
  • 초기 값 옵션
    • 유형: object
    • callback 의 첫 번째 호출에 대한 첫 번째 인수로 사용할 값입니다.

예외 처리:
  • TypeError
    • collection이 비어 있고 initialValue 이 제공되지 않은 경우입니다.

반환 값: any - 다음과 같은 특수한 경우를 제외하고 , callback 의 최종 호출에서 반환된 값입니다.
  • collection이 단일 객체로 구성되어 있고 initalValue 이 제공되지 않은 경우 해당 객체가 반환됩니다.
  • collection이 비어 있으면 initialValue 를 제공 해야 하며 이 반환됩니다.
reduceRright(콜백, 초기 값)any
매개변수:
  • 콜백
    • 유형: function
    • collection의 각 객체에서 오른쪽에서 왼쪽 으로 실행할 함수입니다. 이 함수는 네 개의 인수를 사용합니다:

      • previousValue - 콜백의 마지막 호출에서 이전에 반환된 값 또는 initialValue(제공된 경우)입니다.
      • object - collection에서 처리 중인 현재 객체입니다.
      • index - collection에서 처리 중인 객체의 인덱스입니다.
      • collection - collection 자체.
  • 초기 값 옵션
    • 유형: object
    • callback 의 첫 번째 호출에 대한 첫 번째 인수로 사용할 값입니다.

예외 처리:
  • TypeError
    • collection이 비어 있고 initialValue 이 제공되지 않은 경우입니다.

반환 값: any - 다음과 같은 특수한 경우를 제외하고 , callback 의 최종 호출에서 반환된 값입니다.
  • collection이 단일 객체로 구성되어 있고 initalValue 이 제공되지 않은 경우 해당 객체가 반환됩니다.
  • collection이 비어 있으면 initialValue 를 제공 해야 하며 이 반환됩니다.
removeAllListeners()

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

removeListener(콜백)

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

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

예외 처리:
  • Error
    • callback 가 함수가 아닌 경우.

슬라이스(시작, 종료)[T, ...]
매개변수:
  • 시작하기 옵션
    • 유형: number
    • 기본값입니다: 0
    • 시작 인덱스입니다. 음수인 경우 시작 인덱스는 collection이 끝난 시점부터 계산됩니다.

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

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

collection의 스냅샷을 만듭니다.

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

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

예외 처리:
  • Error
    • 기본 유형의 collection 스냅샷을 만들 때.

실시간 업데이트가 Realm.Results<T> 아닌 을(를) 반환 합니다.
some(콜백, thisArg)boolean
매개변수:
  • 콜백
    • 유형: function
    • collection의 각 객체에 대해 실행할 함수입니다. 이 함수가 true 을 반환하면 이 메서드는 true 을 반환합니다. 이 함수는 세 개의 인수를 사용합니다:

      • object - collection에서 처리 중인 현재 객체입니다.
      • index - collection에서 처리 중인 객체의 인덱스입니다.
      • collection - collection 자체.
  • thisArg 옵션
    • 유형: object
    • callback 이(가) 호출될 때의 this 값입니다.

반환 값: 이 collection의 객체에 대해 를 반환하는 경우 boolean true - , 그렇지 callback true false않으면 .
정렬됨(디스크립터, 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 합계.
values()Iterator<T>
Iterator<T> 컬렉션에 있는 각 Realm 객체의 을 반환 합니다.