1. Web
  2. Web API
  3. IDBObjectStore
  4. getAll()

IDBObjectStore: phương thức getAll()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

Phương thức getAll() của giao diện IDBObjectStore trả về một đối tượng IDBRequest chứa tất cả đối tượng trong object store khớp với tham số được chỉ định hoặc tất cả đối tượng trong store nếu không cung cấp tham số.

Nếu một giá trị được tìm thấy thành công, thì một bản sao có cấu trúc của nó được tạo và đặt làm kết quả của đối tượng request.

Phương thức này tạo ra cùng kết quả cho:

  • một bản ghi không tồn tại trong cơ sở dữ liệu
  • một bản ghi có giá trị undefined

Để phân biệt các trường hợp này, bạn có thể gọi

  1. phương thức openCursor() với cùng khóa. Phương thức đó cung cấp một con trỏ nếu bản ghi tồn tại, và không có con trỏ nếu nó không tồn tại.
  2. phương thức count() với cùng khóa, sẽ trả về 1 nếu hàng tồn tại và 0 nếu không.

Cú pháp

js
getAll()
getAll(query)
getAll(query, count)
getAll(options)

Tham số

Phương thức getAll() có thể nhận các tham số riêng lẻ hoặc một đối tượng options duy nhất chứa các tham số làm thuộc tính.

Các tham số có thể bao gồm:

query Optional

Một khóa hoặc IDBKeyRange cần truy vấn. Nếu giá trị này không được chỉ định, mặc định sẽ là một phạm vi khóa chọn tất cả bản ghi trong object store này.

count Optional

Chỉ định số lượng giá trị cần trả về nếu tìm thấy nhiều hơn một. Nếu nó nhỏ hơn 0 hoặc lớn hơn 2^32 - 1, một ngoại lệ TypeError sẽ được ném.

Nếu một đối tượng parameter được chỉ định, các thuộc tính của nó có thể bao gồm:

query Optional

Xem định nghĩa query ở trên.

count Optional

Xem định nghĩa count ở trên.

direction Optional

Một giá trị liệt kê chỉ định hướng mà các đối tượng được duyệt qua. Các giá trị có thể là:

next

Các đối tượng được duyệt từ đầu, theo thứ tự khóa tăng dần. Đây là giá trị mặc định.

nextunique

Các đối tượng được duyệt từ đầu, theo thứ tự khóa tăng dần. Điều này sẽ tạo ra cùng các đối tượng như next, vì các khóa trùng lặp không được phép trong IDBObjectStore.

prev

Các đối tượng được duyệt từ cuối, theo thứ tự khóa giảm dần.

prevunique

Các đối tượng được duyệt từ cuối, theo thứ tự khóa giảm dần. Điều này sẽ tạo ra cùng các đối tượng như prev, vì các khóa trùng lặp không được phép trong IDBObjectStore.

Giá trị trả về

Một đối tượng IDBRequest mà các sự kiện tiếp theo liên quan đến thao tác này sẽ được kích hoạt trên đó.

Nếu thao tác thành công, giá trị của thuộc tính result của request là một Array chứa giá trị của tất cả bản ghi khớp với truy vấn đã cho, tối đa bằng giá trị của count, nếu count được cung cấp.

Ngoại lệ

Phương thức này có thể gây ra một DOMException thuộc một trong các loại sau:

TransactionInactiveError DOMException

Được ném nếu giao dịch của IDBObjectStore này không hoạt động.

DataError DOMException

Được ném nếu khóa hoặc phạm vi khóa được cung cấp chứa một khóa không hợp lệ hoặc là null.

InvalidStateError DOMException

Được ném nếu IDBObjectStore đã bị xóa hoặc loại bỏ.

TypeError DOMException

Được ném nếu tham số count không nằm trong khoảng từ 0 đến 2^32 - 1, bao gồm cả hai đầu mút.

Đặc tả kỹ thuật

Specification
Indexed Database API 3.0
# ref-for-dom-idbobjectstore-getall①

Tương thích trình duyệt

Xem thêm

Help improve MDN

Learn how to contribute

This page was last modified on by MDN contributors.

View this page on GitHub • Report a problem with this content