Reference
Arcane.preferences.setMany()
Validates the complete bounded batch and writes it atomically; no preference changes when any entry is invalid. Requires preferences.write.
This focused page is derived from the mechanically checked full member inventory.
Syntax
Arcane.preferences.setMany(entries)
Parameters
Plain object containing one to 32 preference key/value entries
Return value
Promise<{keys, count, bytes, totalBytes, maximumBytes}>
Description
Validates the complete bounded batch and writes it atomically; no preference changes when any entry is invalid. Requires preferences.write.
Overview
Validates and writes a related preference batch as one atomic mutation. Prefer this method when several settings describe one UI state and must never be observed half-updated.
Entries and result
Pass a plain object containing 1–32 entries. Every key and value is normalized before any write begins. The entire request rejects when any member is invalid or the merged document exceeds the 1 MiB quota.
Requires preferences.write and resolves to
{keys,count,bytes,totalBytes,maximumBytes}. keys is sorted, bytes is the sum
of the encoded values in this batch, and totalBytes covers the resulting full
preferences envelope.
Example
async function saveReadingPreferences() {
return Arcane.preferences.setMany({
'reader.fontScale': 1.1,
'reader.lineLength': 'medium',
'reader.voice': 'onyx'
});
}
const receipt = await saveReadingPreferences();
console.log(`Updated ${receipt.count} preferences`);