Canvas SDK

Getting started

How environments work

Toolbar and footer

Parameters and controls

Text and expressions

Marking answers

Chalk schema

Data-driven style

?

Canvas SDK
Marking answers

/

Marking answers

How a question’s answer is judged: a maths answer against its expected value and form, a text answer against its accepted strings, and a choice scored by the options picked. Then where the reader stands on a scene’s tasks: each part’s status, reported as they work, and the one status the scene shows for them all.

@internote/canvas-sdk18 exports

On this page

Functions Classes Constants Interfaces Types

A question judges a reader's answer against what its author expects. Each kind of answer has its own judge:

judgeMaths checks a maths answer: the right shape, only the letters the question allows, equal in value to the expected answer, and in the form asked for (exact, simplified or rounded(n)).
judgeText accepts a text answer that matches any accepted string, ignoring case and extra spaces.
judgeChoice scores a multiple choice by the options picked.

Each returns a verdict, and a maths verdict carries a sentence the reader can act on when the answer is wrong.

equivalent is the test beneath judgeMaths: whether two expressions take the same value wherever both are defined.

#Functions

combineTaskStatus

Combines every part's status into the scene's one: any part open keeps the scene incomplete; once all are settled, all correct is correct, all incorrect is incorrect, and anything else is partial.

Returns whether two expressions take the same value everywhere both are defined, or undefined when too few sampled points were defined on both sides to say.

Judges a choice from the indices the reader selected and the indices of the correct options.

Judges a reader's maths answer against what a question expects, and says why when it is wrong.

Judges a text answer: correct when, ignoring case and surrounding or repeated whitespace, it matches any one of the accepted strings.

Parses a form: value, exact, simplified or rounded(n) with n a whole number from 0 to 10, into a MathsForm, or returns why it could not be read.

roundedAnswerText

Returns a numeric expectation written to a number of decimal places, as LaTeX, or null when a component is not a number.

Returns the key a blank-canvas task part reports under: its author's #id, else its instance id.

#Classes

One scene's task parts and where the reader stands on each.

#Constants

BLANK_TASK_OWNER

The owner blank-canvas content reports under, beside each environment's id.

#Interfaces

ChoiceJudgement

The verdict on a choice, and the fraction of it that was right.

MathsExpectation

What a maths question expects, read from its compiled attributes.

What a task part reports through: its status, by the part's key within its owner.

#Types

The form a maths answer must be written in, as a question's form: declares it.

The verdict on one maths answer, with a sentence for the reader when it is not correct.

Why a maths answer was judged incorrect: a different value, the wrong shape, the right value in the wrong form, or a letter the question does not allow.

Where the reader stands on one task part, or on a scene's tasks together.

Where a question stands: not yet answered, or the verdict on its last answer.

Last updated 26 September 2026

← PreviousText and expressions Next →Colour

On this page

Functions Classes Constants Interfaces Types

Privacy Terms Contact Support