pkcs11.getModuleSlots()
Enumerate a module's slots. This function returns an array containing one entry for each slot. Each entry contains the slot's name and, if the slot contains a token, information about the token.
You can only call this for a module that is installed in Firefox.
This is an asynchronous function that returns a Promise
.
Syntax
var getting = browser.pkcs11.getModuleSlots(
name // string
)
Parameters
name
string
. Name of the module. This must match thename
property in the PKCS #11 manifest for the module.
Return value
A Promise
that will be fulfilled with an array of objects, one for each slot that the module provides access to. Each object has two properties:
name
: the name of the slottoken
: if a token is present in this slot, aToken
object. If no token is present in the slot, this property isnull
.
Token
objects have the following properties:
name
string
. Name of the token.manufacturer
string
. Name of the token's manufacturer.HWVersion
string
. Hardware version, as a PKCS #11 version number (two 32-bit integers separated with a dot, like "1.0".FWVersion
string
. Firmware version, as a PKCS #11 version number (two 32-bit integers separated with a dot, like "1.0".serial
string
. Serial number, whose format is defined by the token specification.isLoggedIn
boolean
:true
if the token is logged on already,false
otherwise.
If the module could not be found or some other error occurs, the promise will be rejected with an error message.
Browser compatibility
BCD tables only load in the browser
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Examples
Installs a module, then lists its slots and list the tokens they contain:
function onInstalled() {
return browser.pkcs11.getModuleSlots("my_module");
}
function onGotSlots(slots) {
for (slot of slots) {
console.log(`Slot: ${slot.name}`);
if (slot.token) {
console.log(`Contains token: ${slot.token.name}`);
} else {
console.log('Is empty');
}
}
}
browser.pkcs11.installModule("my_module")
.then(onInstalled)
.then(onGotSlots);