Method jsonInit

packages/blockly/core/block.ts:1755–1868

* Initialize this block using a cross-platform, internationalization-friendly * JSON description. * * @param json Structured data describing the block.

(json: AnyDuringMigration)

   * @param json Structured data describing the block.
   */
  jsonInit(json: AnyDuringMigration) {
    const warningPrefix = json['type'] ? 'Block "' + json['type'] + '": ' : '';

    // Validate inputs.
    if (json['output'] && json['previousStatement']) {
      throw Error(
        warningPrefix + 'Must not have both an output and a previousStatement.',
      );
    }

    // Validate that each arg has a corresponding message
    let n = 0;
    while (json[`args${n}`]) {
      if (json[`message${n}`] === undefined) {
        throw Error(
          warningPrefix +
            `args${n} must have a corresponding message (message${n}).`,
        );
      }
      n++;
    }

    // Set basic properties of block.
    // Handle legacy style object format for backwards compatibility
    if (json['style'] && typeof json['style'] === 'object') {
      this.hat = (json['style'] as {hat?: string}).hat;
      // Must set to null so it doesn't error when checking for style and
      // colour.
      json['style'] = null;
    }
    if (json['style'] && json['colour']) {
      throw Error(warningPrefix + 'Must not have both a colour and a style.');
    } else if (json['style']) {
      this.jsonInitStyle(json, warningPrefix);
    } else {
      this.jsonInitColour(json, warningPrefix);
    }

    // Interpolate the message blocks.
    let i = 0;
    while (json[`message${i}`] !== undefined) {
      this.interpolate(
        json[`message${i}`] || '',
        json[`args${i}`] || [],
        // Backwards compatibility: lastDummyAlign aliases implicitAlign.
        json[`implicitAlign${i}`] || (json as any)[`lastDummyAlign${i}`],
        warningPrefix,
      );
      i++;
    }

    if (json['inputsInline'] !== undefined) {
      eventUtils.disable();
      this.setInputsInline(json['inputsInline']);
      eventUtils.enable();
    }

    // Set output and previous/next connections.