Skip to content

PhetioObject

Overview

Base type that provides PhET-iO features. An instrumented PhetioObject is referred to on the wrapper side/design side as a "PhET-iO Element". Note that sims may have hundreds or thousands of PhetioObjects, so performance and memory considerations are important. For this reason, initializePhetioObject is only called in PhET-iO brand, which means many of the getters such as phetioState and phetioDocumentation will not work in other brands. We have opted to have these getters throw assertion errors in other brands to help identify problems if these are called unexpectedly.

@author Sam Reid (PhET Interactive Simulations) @author Michael Kauzmann (PhET Interactive Simulations)

Type PhetioObjectOptions

import type { PhetioObjectOptions } from 'scenerystack/tandem';
  • tandem?: Tandem
    This is the only place in the project where this is allowed
  • descriptionTandem?: Tandem
  • phetioType?: IOType
  • phetioEventType?: EventType
  • phetioEventMetadata?: EventMetadata | null
  • tandemNameSuffix?: string | string[] | null
    The element's tandem name must have a specified suffix. This is to enforce naming conventions for PhET-iO. If string[] is provided, the tandem name must have a suffix that matches one of the strings in the array. null means that there is no constraint on tandem name. The first character is not case-sensitive, to support uses like 'thermometerNode' versus 'upperThermometerNode'.
  • & StrictOmit<Partial<PhetioElementMetadata>, "phetioTypeName" | "phetioArchetypePhetioID" | "phetioIsArchetype" | "phetioEventType"> & DisposableOptions

Source Code

See the source for PhetioObject.ts in the tandem repository.