Capability first · transport second

Questionnaire.js

Evaluates whether a one-time questionnaire prompt is due without performing the prompt.

SDK 0.5.18Runtime 0.8.12Protocol arcane/1
On this page

Overview

Evaluates whether a one-time questionnaire prompt is due without performing the prompt.

  • Artifact
    Questionnaire.js · esm
  • Classification
    public first party
  • Availability
    Cross-host
  • Normalization
    Normalized fail-closed boolean.

Import and lifecycle

JavaScript
import * as module from '/arcane/modules/Questionnaire.js';

Per-instance in-memory delay only; construction starts no timer and performs no persistence or prompt.

Application-facing behavior: Notification default and Questionnaire with timing/check methods.

Protocol and host implementation

In-process clock only This detail does not widen the application-facing API or grant authority.

Exports, signatures, parameters, and results

BindingFormDeclaration or signatureParameter syntax
DEFAULT_QUESTIONNAIRE_NOTIFICATION_TIME_MSvariable · valuevariable DEFAULT_QUESTIONNAIRE_NOTIFICATION_TIME_MS
Questionnaireclassclass Questionnaire
MemberKindExact public declarationParameter syntax
Questionnaire.setNotificationTimemethodsetNotificationTime(notificationTime)notificationTime
Questionnaire.checkQuestionnaireShownmethodcheckQuestionnaireShown(firstBootUp,questionnaireShown,now=Date.now())firstBootUp,questionnaireShown,now=Date.now()

Parameter meanings and results

DEFAULT_QUESTIONNAIRE_NOTIFICATION_TIME_MS is exactly seven 24-hour periods. setNotificationTime(positive finite milliseconds) returns void. checkQuestionnaireShown(firstBootUp positive safe integer, questionnaireShown exact false, now=Date.now()) returns boolean and fails closed for invalid/rollback state.

Events, side effects, and errors

Source-literal CustomEvent dispatches

No source-literal CustomEvent dispatch is part of this artifact.

Lifecycle and event flow

This artifact has no additional documented lifecycle event flow.

Direct coded failures

This artifact directly assigns no stable coded failure.

Exported Error subclasses

This artifact exports no Error subclass.

Documented failure behavior

  • RangeError only for invalid setNotificationTime().

Availability and capabilities

Cross-host. Normalized fail-closed boolean.

None.

Contract example

JavaScript
import {Questionnaire} from '/arcane/modules/Questionnaire.js';

const questionnaire = new Questionnaire();
questionnaire.setNotificationTime(1000);
console.log(questionnaire.checkQuestionnaireShown(Date.now()-1000, false));

No direct Core call is claimed for this artifact. Any injected provider or consuming module retains its own documented authority.