Realm.목록

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

목록은 단일 유형(목록의 typeoptional 속성으로 표시됨)의 값만 저장할 수 있고 쓰기 트랜잭션( 쓰기 트랜잭션 (write transaction)) 내에서만 수정할 수 있다는 점을 제외하면 대부분 일반 JavaScript 배열처럼 동작합니다.

분량
읽기 전용

collection의 값 수입니다.

유형:
number
옵션
읽기 전용

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

유형:
boolean
유형
읽기 전용

collection의 값 유형 입니다.

유형:
string
()T or undefined

목록에서 마지막 값을 제거하고 반환합니다.

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

반환 값: T 또는 목록이 비어 있으면 undefined .
push()number

목록 끝에 하나 이상의 값을 추가합니다.

매개변수:
  • value 반복 가능
    • 유형: T
    • 목록에 추가할 값입니다.

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

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

값을 추가한 number 후 목록의 새 와 동일한 을(를) 반환 합니다.length
shift()T or undefined

목록에서 첫 번째 값을 제거하고 반환합니다.

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

반환 값: T 또는 목록이 비어 있으면 undefined .
스플 라이스(index, count, value)[T, ...]

값을 제거하거나 새 값을 삽입하여 목록의 내용을 변경합니다.

매개변수:
  • index
    • 유형: number
    • 시작 인덱스입니다. 목록의 길이보다 크면 시작 인덱스가 대신 해당 길이로 설정됩니다. If negative, then the start index will be counted from the end of the list (e.g. list.length - index).

  • 카운트 옵션
    • 유형: number
    • 목록에서 제거할 값의 수입니다. 제공하지 않으면 시작 인덱스부터 목록 끝까지 모든 값이 제거됩니다.

  • value 옵션 반복 가능
    • 유형: T
    • 목록에 삽입할 값( index 부터 시작)

목록에서 제거된 값을 포함하는 [T, ...] 을(를) 반환 합니다. 제거된 값이 없는 경우 배열은 비어 있습니다.
unshift()number

목록 시작 부분 에 하나 이상의 값을 추가합니다.

매개변수:
  • value 반복 가능
    • 유형: T
    • 목록에 추가할 값입니다.

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

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

값을 추가한 number 후 목록의 새 와 동일한 을(를) 반환 합니다.length
기호.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 객체의 을 반환 합니다.