partial - API reference

API reference › @evolu/common › Type › partial

function partial<Props>(
  props: Props,
  ..._validation: [ObjectValidationError<Props>] extends [never]
    ? []
    : [ValidationFailure<ObjectValidationError<Props>>]
): StrictObjectType<PartialObjectProps<Props>>;

Defined in: packages/common/src/Type.ts:8495

Creates an object Type with every property optional.

No property is required, but every present property must still satisfy its Type.

Example

import { PositiveInt, String, partial } from "@evolu/common";

const PartialUser = partial({ name: String, age: PositiveInt });

expectOk(PartialUser.fromUnknown({}), {});
expectOk(PartialUser.fromUnknown({ name: "Ada" }), { name: "Ada" });
expect(PartialUser.fromUnknown({ age: -1 }).ok).toBe(false);