Clique sobre os tópicos listados abaixo para navegar até o conteúdo desejado.

Os conceitos básicos sobre variáveis, contantes e escopo foram vistos em Tutorial Portugol: Variáveis sendo a leitura recomendada.

Para armazenar informações em nossos programas escritos em TS precisamos utilizar variáveis e constantes. Nesta parte do tutorial vamos aprender sobre o assunto esses assuntos.

Para a declaração de variáveis em TS, utilizamos a palavra reservada let. A linguagem TS possui tipagem dinâmica, não sendo necessário a declaração do tipo da variável.

Sintaxe

let nome_variavel:tipo_dado;
let nome_variavel = valor;

Exemplo 1

let nome_variavel:string; //undefined

TS permite que essa declaração seja feita em apenas uma linha. A sintaxe é semelhante ao que foi visto no exemplo acima. Nesse tipo de declaração os nomes das variáveis são separados por (,).

Sintaxe

let nome_variavel1, nome_variavel2, nome_variavelN;

Exemplo 2

let str:string, num:number; //undefined

A atribuição de valor a uma variável é feita utilizando o operador (=) podem ser em linha ou não. Outros operadores serão vistos mais adiante.

Sintaxe

nome_variavel1:tipo_de_dado = valor

Exemplo 3

let valor:number = 1;

A declaração de constantes em TS é feita utilizando a palavra reservada const semelhante a várias outras linguagens no estilo-C. Uma vez iniciada uma constante não pode ter seu conteúdo alterado.

O conceito de constantes foi visto em Tutorial Portugol e Tutorial C.

Sintaxe

const NOME_CONSTANTE:tipo_dado= valor;

Exemplo 4

const NUM:number = 100;

A linguagem TS permite que essa declaração seja feita em apenas uma linha. A sintaxe é semelhante ao que foi visto no exemplo acima. Nesse tipo de declaração os nomes das variáveis são separados por (,).

Sintaxe

const CONSTANTE:tipo_dado = valor1, CONSTANTE2:tipo_dado2 = valor2, CONSTANTEN:tipo_dadoN = valorN;

Exemplo 5

const num:number = 100,str:string="TESTE";

A visibilidade ou escopo de variáveis e constantes em TS são divididas em 3 tipos: Bloco, Função e Global.

Qualquer declaração de constantes ou variáveis feitas fora de uma função tem visibilidade global podendo ser acessada por qualquer função ou arquivo .ts.

Exemplo 6

let variavel; //global

function funcao() {
  //omitido
}

Qualquer declaração de constantes ou variáveis feitas dentro de uma função tem visibilidade local/função podendo ser acessada dentro da própria função. Constantes e variáveis globais podem ser acessadas normalmente dentro de funções.

Exemplo 7

let variavel; //global

function funcao() {
  let variavel; //função
}

As variáveis e constantes definidas dentro de um bloco de código tem escopo de bloco e não podem ser acessadas de fora. Variáveis e constantes globais podem ser acessadas dentro do bloco.

Exemplo 8

let var1:number;
{ //bloco
    let var2:number;
    //omitido
}

Em relação a POO, as variáveis de classe tem seu escopo e visibilidade definidas por modificadores de acesso. Esses podem ser public, private e protected. O assunto modificadores pode ser visto em Typscript: Encapsulamento

Módulos ou bibliotecas do usuário contem recursos que possuem escopo global, local , função e classe. O assunto módulo pode ser visto em Typscript: Módulo.

A linguagem TS, assim como Lua, Python e PHP, possui a característica de inferência de dados. Isso significa que quanto criamos uma variável não precisamos declarar seu tipo. A inferência do tipo de dado está associada ao valor atribuído à variável.

Exemplo 9

let numero = 10;
numero = "string";

Uma vez que a inferência é feita, a variável afetada não pode receber outros tipos de dados além do tipo de dado informado pelo valor inicial atribuído.

Agora que já temos conhecimento sobre os tipos básicos de dados presentes na linguagem TS, vamos ver alguns exemplos de declaração de variáveis nessa.

Exemplo 10

const CONSTANTE = 3.14;
let valor:number = 999;
let float1:number = 1.99;
let string1:string = 'string'
let string2:string = "string"
let array1:number[] = [1,2,3];
let matriz:number[][] = [[1,],[1,2]];
let booleano:boolean = false;
let nome_variavel:any //qualquer tipo

let a:number = 10
let b:number = 0x10 //hexa
let c:number = 0o20 //octal
let d:number = 0b00001111 //binário 
let e:number = 0b1111_0000 //binário c/ separador
let f:number = 1_150 //inteiro com separador
let g:number = 0xAA_BB_CC_DD //hexa com separador

Outras variáveis de tipos de dados mais complexos serão vistos ao longo do tutorial, não sendo necessário uma preocupação inicial.

A linguagem TS fornece o recurso de desempacotar(unpacking) valores de arrays, propriedades de objetos e atribui-los à variáveis.

Sintaxe

let [var1, var2] = [valor1, valor2];
[var1, var2] = [valor1, valor2];

Exemplo 11: array

let vet:number[] = [1,2,3]
let [a,b,c] = vet;

Exemplo 11.2:objeto

let objeto: { campo1: string, campo2: number } = {
  campo1: "string",
  campo2: 1
};

let {campo1} = objeto
let {campo2} = objeto
console.log(campo1,campo2)

A linguagem TS, diferente de outras linguagens, permite que sejam criadas variáveis utilizando o recurso de união de tipos.

Sintaxe

tipo_dado1 | tipo_dado2
tipo1 & tipo2

Exemplo 12

let valor:number|string;

valor = "teste"
valor = 1;

Os identificadores(Varíaveis, constante e outros) em TS, assim como em várias outras linguagens, precisam seguir alguma regras quando declarados:

Regras

1. Devem conter apenas letras, números, underscore e $.
2. Devem iniciar com letra ou underscore, $ ou _
3. Identificadores são case-sensitive. Nome e NOME são diferentes
4. Não podem utilizar palavras reservadas

Exemplo 13

//válidos
let nome:string;
let NOME:string;
let _nome:string;

//inválidos
let 1nome:string;
let um variavel::string;
let 123:number;

A linguagem TS é case-sensitive assim como JS e outras linguagens. Quando declaramos identificadores homônimos em caixa alta e caixa baixa, esses são vistos como identificadores distintos como mostrado no exemplo a seguir:

Exemplo 14

function funcao1() {
    console.log("funcao1")
}

function FUNCAO1()
{
    console.log("funcao1")
}

let a:number = 10
let A:number = 10

console.log(a,A)

Descarte de valores retornados por unpacking é feito omitindo-se a variável a qual está destinada sua atribuição mantendo-se o separador (,) como pode ser visto nas sintaxes abaixo:

Sintaxe

[varA, , ]  //descarte do 2o e 3o valores
[varA, varB, ] //descarte do 3o valor
[ , varB, varC] //descarte do 1o valor
[ ,varB, ] //descarte do 1o e 3o valores
[ , , varC] //descarte do 1o e 2o valores

Exemplo 15

let array:any[] = ['a',true,"string"]

let [a,,] = array //descarte de true e "string"
console.log(a)

let [b,c,] = array //descarte de "string"
console.log(b,c)

let[,,g] = array //descarte de 'a' e true
console.log(g)

let[,h,] = array //descarte de 'a' e "string"
console.log(h)

Saída

"a" 
"a", true
"string" 
true

O underscore(_) também pode ser utilizado como para informar que o valor deve ser descartado logicamente.

Exemplo 16

let array = ['a',true,"string"]

let [a,_,__] = array //descarte de true e "string"
console.log(a)

let [b,c,___] = array //descarte de "string"
console.log(b,b)

Saída

"a"
"a", true 

Uma variável nullable aceita valores de seu tipo declarado e também null. Em TS isso é possível adicionando null no tipo da variável como na sintaxe abaixo:

Sintaxe

let nome_var: tipo_dado | null

Exemplo 17

let a: number | null
a = 10
console.log(a)

a = null
console.log(a)

Saída

10
null

Os comandos de decisão devem ser utilizados para verificar uma variável antes de utilizá-la caso seu valor seja nulo.

Como toda linguagem, TS possui um conjunto de palavras reservadas(keywords) que são reconhecidas e não podem ser utilizadas como nome de variáveis e constantes ou funções.

1. 26/12/2025 - revisão 3 - Adição: literais em Ex. 10, case-sensitive, unpacking Ex 11.2, discard e variável nullable
2. 27/08/2025 - revisão 2 - Ajustes: pontuais, sintaxes e target de links
3. 13/09/2024 - revisão 1 - Correção em estilo/css de exemplos 1, 2 e 3, pequenos ajustes gramaticais e melhorias
4. 27/02/2024 - versão inicial