Aula: Utilizando Destruturação de Array no FiveM

Nesta aula, você aprenderá como utilizar a destruturação de arrays no JavaScript, com foco em um exemplo prático no ambiente do FiveM.

Vamos explorar a função GetEntityCoords, que retorna as coordenadas de uma entidade no jogo, e usar a destruturação para atribuir os valores diretamente a variáveis.

O que é destruturação de array?

Destruturação de array é uma funcionalidade do JavaScript que permite extrair elementos de um array e atribuí-los a variáveis de forma concisa e eficiente.

É especialmente útil quando você trabalha com funções que retornam arrays.

Exemplo básico:

Imagine um "array" chamado numeros que contem 3 elementos 1,2,3 :

        let numeros = [1, 2, 3];

Perceba que normalmente utilizariamos o array numeros começando o acesso com indicie "0" assim:

        console.log(numeros[0]);
        console.log(numeros[1]);
        console.log(numeros[2]);

Ao utilizarmos destruturação, podemos criar uma variável para cada um dos itens do array. Exemplo: variáveis a,b,c

        let numeros = [1, 2, 3];
        let [a, b, c] = numeros; // a = 1, b = 2, c = 3

Veja que agora podemos acessar cada um dos itens pelas suas respectivas variáveis:

        console.log(a);
        console.log(b)
        console.log(c)

Aplicando no FiveM

Vamos usar a destruturação para trabalhar com a função GetEntityCoords, que retorna as coordenadas x, y e z de uma entidade no jogo.

Exemplo: Exibindo Coordenadas de um Ped

Sem destruturação:

    // Obtém o ped do jogador
    const ped = PlayerPedId();

    // Usa GetEntityCoords para obter as coordenadas do ped
    let coords = GetEntityCoords(ped, true);
    let x = coords[0];
    let y = coords[1];
    let z = coords[2];

    // Exibe as coordenadas no console
    console.log(`Coordenadas do Ped: X: ${x}, Y: ${y}, Z: ${z}`);

Com destruturação:

    // Obtém o ped do jogador
    const ped = PlayerPedId();

    // Usa GetEntityCoords para obter as coordenadas do ped
    let [x, y, z] = GetEntityCoords(ped, true);

    // Exibe as coordenadas no console
    console.log(`Coordenadas do Ped: X: ${x}, Y: ${y}, Z: ${z}`);

Conclusão

A destruturação de arrays torna o código mais limpo e fácil de entender, sendo uma ferramenta poderosa para projetos como scripts no FiveM.