Skip to content

Deprecations

Anything listed here still works. A removal only ever happens in a major release, and only after the member has been marked deprecated in a minor one. Each entry names what to use instead.

How you are told:

  • @deprecated in the source. It shows in your editor, in tsc and lint rules, and in the custom-elements manifest. It only reaches you if you use TypeScript or typed JSX.
  • A console warning, for the few members where a host can act on it. It is printed once per element and names the replacement. Marked below.
  • The release notes and the host migration notes for every change that touches the Public API (in Storybook).

Removed in the next major release

DeprecatedUse insteadConsole warning
test-navigation.qtiContextqtiTest.qtiContext: the same value, same behaviouryes, on write
qti-test-context-updated eventqti-state-changed, and qtiTest.state to restoreno
SessionContext.navItemLoading and navTestLoadingnothing: the library never set themno

test-navigation.qtiContext is an alias today: it reads and writes the enclosing qti-test’s value, so setting the shuffle seed there keeps working. See Persist & restore.

Planned, not yet marked in the source

These are decided but not deprecated in code yet, so nothing warns about them.

PlannedReplacement
sessionContext.viewview in the config, mirrored until the old one goes
Dispatching on-test-switch-view and test-show-candidate-correctiona view property and a showCandidateCorrection method

Deprecated, no removal date

DeprecatedUse insteadConsole warning
Assigning or reading qtiTest.testContext to persist a sessionqtiTest.state. testContext is still the internal providerno
item.responsesitem.variablesno
ConfigContext.disableAfterIfMaxChoicesReacheddisableAfterMaxReachedyes
qti-choice-interaction orientationthe qti-orientation-horizontal / -vertical classesno
IInteractionRegisteredInteractionno
DragDropInteractionMixin, TouchDragAndDrop and the other legacy drag-drop mixinsDragDropSlottedMixin (and DragDropSlottedSortableMixin)no
test-paging-buttons-stamp, test-section-buttons-stampthe <template>-driven pattern used by test-scoring-buttonsno
test-show-correct-responsethe <template>-driven pattern used by test-view-toggleno
filterArgsForSpreadthe spreadArgs directiveno

“No removal date” means it is marked deprecated and will be removed in a later major release, not the next one. It moves to the first table when a date is set.