IDBKeyRange: upperOpen property

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨July 2015⁩.

Note: This feature is available in Web Workers.

The upperOpen read-only property of the IDBKeyRange interface returns a boolean indicating whether the upper-bound value is included in the key range.

Value

A boolean value:

Value	Indication
`true`	The upper-bound value is not included in the key range.
`false`	The upper-bound value is included in the key range.

The following example illustrates how you'd use a key range. Here we declare keyRangeValue = IDBKeyRange.upperBound("F", "W", true, true); — a range that includes everything between "F" and "W" but not including them — since both the upper and lower bounds have been declared as open (true). We open a transaction (using IDBTransaction) and an object store, and open a Cursor with IDBObjectStore.openCursor, declaring keyRangeValue as its optional key range value.

After declaring the key range, we log its upperOpen property value to the console, which should appear as "true": the upper bound is open, so won't be included in the range.

Note: For a more complete example allowing you to experiment with key range, have a look at our IDBKeyRange-example repo (view the example live too.)

function displayData() {   const keyRangeValue = IDBKeyRange.bound("F", "W", true, true);   console.log(keyRangeValue.upperOpen);    const transaction = db.transaction(["fThings"], "readonly");   const objectStore = transaction.objectStore("fThings");   objectStore.openCursor(keyRangeValue).onsuccess = (event) => {     const cursor = event.target.result;     if (cursor) {       const listItem = document.createElement("li");       listItem.textContent = `${cursor.value.fThing}, ${cursor.value.fRating}`;       list.appendChild(listItem);       cursor.continue();     } else {       console.log("Entries all displayed.");     }   }; }