Function assertQuery

  • URL query decoder with type assertion.

    typia.http.assertQuery() is a function decoding a query string or an URLSearchParams instance, with automatic type casting to the expected type. When property type be defined as boolean or number type, typia.http.assertQuery() will cast the value to the expected type when decoding.

    Also, after decoding, typia.http.assertQuery() performs type assertion to the decoded value by combining with assert function. Therefore, when the decoded value is not following the T type, TypeGuardError or custom error generated by errorFactory would be thrown.

    By the way, as URL query is not enough to express complex data structures, typia.http.assertQuery() function has some limitations. If target type T is notfollowing those restrictions, compilation errors would be occured.

    1. Type T must be an object type
    2. Do not allow dynamic property
    3. Only boolean, bigint, number, string or their array types are allowed
    4. By the way, union type never be not allowed

    Type Parameters

    • T extends object

      Expected type of decoded value

    Parameters

    • input: string | URLSearchParams

      Query string or URLSearchParams instance

    • OptionalerrorFactory: ((props: TypeGuardError.IProps) => Error)

      Custom error factory. Default is TypeGuardError

    Returns Resolved<T>

    Decoded query object

    Jeongho Nam - https://github.com/samchon