How to make oneOf field nullable with typescript and ajv

Question

I have field called platform which can either be a string or a string[] this field can also be nullable/undefined (not passed).

typescript interface

export interface IEntityLeaderboardQuery {
    rank: string;
    entity_types: string[] | string;
    country?: string | undefined;
    region?: string | undefined;
    start_date: string;
    end_date: string;
    top?: string | undefined;
    platform?: string[] | string | undefined;
}

json schema

export const EntityLeaderboardQuerySchema: JSONSchemaType<IEntityLeaderboardQuery> = {
    type: "object",
    properties: {
        rank: { type: "string" },
        entity_types: {
            oneOf: [
                {
                    type: "string",
                },
                {
                    type: "array",
                    items: { type: "string" },
                },
            ],
        },
        country: { type: "string", nullable: true },
        region: { type: "string", nullable: true },
        start_date: { type: "string" },
        end_date: { type: "string" },
        top: { type: "string", nullable: true },
        platform: {
            oneOf: [
                {
                    type: "string",
                    nullable: true,
                },
                {
                    type: "array",
                    items: { type: "string" },
                    nullable: true,
                },
            ],
        },
    },
    required: ["rank", "entity_types", "start_date", "end_date"],
    additionalProperties: false,
};

As you can see ive attempted to add nullable field to both objects within the oneOf array. However there is still an issue with the types

[ERROR] 11:07:49 ⨯ Unable to compile TypeScript: src/api/leaderboard/entity/entity-leaderboard.interface.ts:43:14 - error TS2322: Type '{ type: "object"; properties: { rank: { type: "string"; }; entity_types: { oneOf: ({ type: "string"; } | { type: "array"; items: { type: "string"; }; })[]; }; country: { type: "string"; nullable: true; }; region: { ...; }; start_date: { ...; }; end_date: { ...; }; top: { ...; }; platform: { ...; }; }; required: ("ra...' is not assignable to type 'UncheckedJSONSchemaType<IEntityLeaderboardQuery, false>'. Type '{ type: "object"; properties: { rank: { type: "string"; }; entity_types: { oneOf: ({ type: "string"; } | { type: "array"; items: { type: "string"; }; })[]; }; country: { type: "string"; nullable: true; }; region: { ...; }; start_date: { ...; }; end_date: { ...; }; top: { ...; }; platform: { ...; }; }; required: ("ra...' is not assignable to type '{ type: "object"; additionalProperties?: boolean | UncheckedJSONSchemaType<unknown, false> | undefined; unevaluatedProperties?: boolean | UncheckedJSONSchemaType<unknown, false> | undefined; ... 7 more ...; maxProperties?: number | undefined; } & { ...; } & { ...; } & { ...; }'. Type '{ type: "object"; properties: { rank: { type: "string"; }; entity_types: { oneOf: ({ type: "string"; } | { type: "array"; items: { type: "string"; }; })[]; }; country: { type: "string"; nullable: true; }; region: { ...; }; start_date: { ...; }; end_date: { ...; }; top: { ...; }; platform: { ...; }; }; required: ("ra...' is not assignable to type '{ type: "object"; additionalProperties?: boolean | UncheckedJSONSchemaType<unknown, false> | undefined; unevaluatedProperties?: boolean | UncheckedJSONSchemaType<unknown, false> | undefined; ... 7 more ...; maxProperties?: number | undefined; }'. The types of 'properties.platform' are incompatible between these types. Type '{ oneOf: ({ type: "string"; nullable: boolean; } | { type: "array"; items: { type: "string"; nullable: boolean; }; nullable: boolean; })[]; }' is not assignable to type '{ $ref: string; } | (UncheckedJSONSchemaType<string | string[] | undefined, false> & { nullable: true; const?: undefined; enum?: readonly (string | string[] | null | undefined)[] | undefined; default?: string | ... 2 more ... | undefined; })'. Type '{ oneOf: ({ type: "string"; nullable: boolean; } | { type: "array"; items: { type: "string"; nullable: boolean; }; nullable: boolean; })[]; }' is not assignable to type '{ type: "array"; items: UncheckedJSONSchemaType<string, false>; contains?: UncheckedPartialSchema | undefined; minItems?: number | undefined; ... 4 more ...; additionalItems?: undefined; } & { ...; } & { ...; } & { ...; }'. Type '{ oneOf: ({ type: "string"; nullable: boolean; } | { type: "array"; items: { type: "string"; nullable: boolean; }; nullable: boolean; })[]; }' is missing the following properties from type '{ type: "array"; items: UncheckedJSONSchemaType<string, false>; contains?: UncheckedPartialSchema | undefined; minItems?: number | undefined; ... 4 more ...; additionalItems?: undefined; }': type, items

43 export const EntityLeaderboardQuerySchema: JSONSchemaType = {

ajv: 8.6.2
typescipt: 4.3.5

https://replit.com/join/ngjynszvjr-kaykhan

At first undefined is not a type in json, it is however supported in json schema through the "optional": true property, if you have to support null type. Also: normally you can use {type: "null"} but as @Ryan wrote, he has problem using "null" as a type (this depends on the json validator you are using). At last, I would recommend trying using a lib like npmjs.com/package/json-schema-to-typescript just to convert your typescript definition to a json schema. As of today, the json schema is still a draft — Flavien Volken
– Flavien Volken, Commented Oct 13, 2021 at 10:03

Salvador Real · Accepted Answer · 2022-06-15 01:31:10Z

2

It doesn't compile as typescript thinks it's trying to assign an optional type to a non-optional type.

The problem arises since you are using the assignment of nullable: true to the items of oneOf, you must specify outside since the property is using optional chaining ? platform?: string[] | string

platform: {
  nullable: true, //<-- nullable Here
  type: ['string', 'array'], //<-- when using "nullable" you must specify the types
  oneOf: [
    { 
      type: 'string' 
    },
    {
      type: 'array',
      items: { type: 'string' },
    }
  ]
}

If you are using strict mode with Ajv you will probably get a warning:

strict mode: use allowUnionTypes to allow union type keyword at "#/properties/platform" (strictTypes)

Enabling allowUnionTypes should work:

const ajv = new Ajv({ allowUnionTypes: true })

answered Jun 15, 2022 at 1:31

Salvador Real

1561 silver badge7 bronze badges

Sign up to request clarification or add additional context in comments.

Comments

Ryan H. · Accepted Answer · 2021-10-01 14:47:20Z

0

I had a similar situation and this worked for me:

oneOf: [
    {
        type: "string",
    },
    {
        type: "array",
        items: { type: "string" },
    },
    {
        type: "object",
        nullable: true,
    },
],

Using { type: "null" } did not work.

answered Oct 1, 2021 at 14:47

Ryan H.

7,9244 gold badges41 silver badges46 bronze badges

Collectives™ on Stack Overflow

How to make oneOf field nullable with typescript and ajv

2 Answers 2

Comments

Comments

Your Answer

Hot Network Questions

Collectives™ on Stack Overflow

2 Answers 2

Comments

Comments

Your Answer

Sign up or log in

Post as a guest

Related