Methods
-
<inner> registerType(type, handle)
-
Registra um tipo de valor a ser suportado pela função validateString.
Parameters:
Name Type Description type
string | Array.<string> Identificação do tipo.
handle
function Função que irá receber os mesmos parâmetros de validateString e é responsável por validar e retornar o valor no tipo desejado.
-
<inner> validateString(value, type [, options])
-
Valida e retorna um texto convertido no tipo desejado.
Essa função busca apenas dar compatibilidade com a antiga função global validateString e seu uso não é mais recomendado.
Para fins de compatibilidade, este método também aceita os parâmetros utilizando a seguinte assinatura:
validateString(value, type, max, min, caseType, classKey, displayFormat)
Parameters:
Name Type Argument Description value
* Valor a ser validado.
type
string Tipo desejado para o valor informado. Os seguintes tipos são suportados: 'string', 'int64', 'int32', 'number', 'interval', 'date', 'time', 'boolean', 'email', 'cep', 'phone', 'lookup', 'color', 'pis', 'cpf', 'cnpj', 'cpfcnpj', 'angle', 'latitude', 'longitude', 'comp', 'banco', 'agencia' e 'cheque'.
Para fins de compatibilidade, os seguintes tipos também são aceitos:
- 'memo', 'blob' e qualquer tipo que contenha 'char' (ex: 'varchar') são tratados como 'string';
- 'numeric' é tratado como 'number';
- 'integer' é tratado como 'int64';
- 'hora' é tratado como 'time';
- 'fone' é tratado como 'phone'.
- 'cgccpf' é tratado como 'cpfcnpj'.
options
Object <optional>
Opções de validação.
Properties
Name Type Argument Description max
number | Date <optional>
Valor máximo aceito. Cada tipo poderá dar um significado diferente para esse parâmetro, podendo inclusive ignorá-lo. De uma forma geral, será considerado o valor máximo para tipos numéricos e o tamanho máximo para tipos textuais.
min
number | Date <optional>
Valor mínimo aceito. Cada tipo poderá dar um significado diferente para esse parâmetro, podendo inclusive ignorá-lo. De uma forma geral, será considerado o valor mínimo para tipos numéricos e o tamanho mínimo para tipos textuais.
caseType
string <optional>
Para tipos textuais, indicará o tipo de case desejado. Valores possíveis: 'upper', 'lower', 'name', 'title' e 'statement'. Ver module:@nginstack/engine/lib/string/adjustCase para mais detalhes.
classKey
number <optional>
Para o tipo lookup, indica a classe onde podem ser encontrados os registros indicados por value.
displayFormat
DateFormat | LatitudeFormat | LongitudeFormat | AngleFormat <optional>
Indica o formato aceito para o campo.
locale
'pt-br' | 'en-us' <optional>
Localidade a ser utilizada. Por padrão é 'pt-br'.
Returns:
Retorna value convertido no tipo desejado.
- Type
- *