Ao iniciar este projeto, você concorda com as diretrizes do Código de Ética e Conduta e do Manual da Pessoa Estudante da Trybe.
Você já usa o GitHub diariamente para desenvolver os exercícios, certo? Agora, para desenvolver os projetos, você deverá seguir as instruções a seguir. Atenção a cada passo, e se tiver qualquer dúvida, nos envie por Slack! #VQV 🚀
Aqui você vai encontrar os detalhes de como estruturar o desenvolvimento do seu projeto a partir desse repositório, utilizando uma branch
específica e um Pull Request para colocar seus códigos.
-
Requisitos obrigatórios:
- 1 - Crie uma função usando o operador &&
- 2 - Crie uma função que calcule a área de um triângulo
- 3 - Crie uma função que divida a frase
- 4 - Crie uma função que use concatenação de strings
- 5 - Crie uma função que calcule a quantidade de pontos no futebol
- 6 - Crie uma função que calcule a repetição do maior número
- 7 - Crie uma função de Caça ao rato
- 8 - Crie uma função FizzBuzz
- 9 - Crie uma função que Codifique e Decodifique
- 10 - Crie uma função de Lista de tecnologias
Requisitos bônus:
- Escrever códigos em JavaScript que usam variáveis e tipos primitivos;
- Utilizar conceitos da linguagem como a tipagem dinâmica e operadores lógicos/aritméticos/de atribuição no seu código;
- Criar códigos que usam estruturas condicionais, como o if/else ;
- Manipular arrays (listas);
- Utilizar o comando for ;
- Quebrar grandes problemas em pequenos;
- Utilizar a lógica de programação na resolução de problemas;
- Manipular objetos;
- Utilizar o comando for/in ;
- Utilizar funções para organizar e estruturar o seu código;
Para entregar o seu projeto você deverá criar um Pull Request neste repositório.
Este Pull Request deverá conter os arquivos challenges.js
e challenges2.js
com suas funções implementadas.
Todas as funções já estão declaradas nos arquivos challenges.js
e challenges2.js
. Você pode criar outras funções para auxiliarem as já existentes. Contudo Não altere o nome das funções que já existem.
Os parâmetros das funções já existentes podem e devem ser alterados.
Lembre-se que você pode consultar nosso conteúdo sobre Git & GitHub sempre que precisar!
- Você vai implementar funções a partir de requisitos;
- Você vai desenvolver funções seguindo os requisitos especificados para o correto comportamento de cada uma delas.
- Será
1
dia de projeto. - Data de entrega para avaliação final do projeto:
07/09/2021 - 14:00h
.
- Clone o repositório
git clone [email protected]:tryber/sd-016-b-project-playground-functions.git
- Entre na pasta do repositório que você acabou de clonar:
cd sd-016-b-project-playground-functions
- Instale as dependências e inicialize o projeto
- Instale as dependências:
- npm install
- Crie uma branch a partir da branch
master
- Verifique que você está na branch
master
- Exemplo:
git branch
- Exemplo:
- Se não estiver, mude para a branch
master
- Exemplo:
git checkout master
- Exemplo:
- Agora, crie uma branch onde você vai guardar os
commits
do seu projeto- Você deve criar uma branch no seguinte formato:
nome-sobrenome-playground-functions
- Exemplo:
git checkout -b joao-silva-playground-functions
- Você deve criar uma branch no seguinte formato:
- Realize alguma mudança e adicione ao stage do Git e faça um
commit
- Verifique que as mudanças ainda não estão no stage
- Exemplo:
git status
(devem aparecer listados os novos arquivos em vermelho)
- Exemplo:
- Adicione o novo arquivo ao stage do Git
- Exemplo:
git add .
(adicionando todas as mudanças - que estavam em vermelho - ao stage do Git)git status
(devem aparecer listados os arquivos em verde)
- Exemplo:
- Faça o
commit
inicial- Exemplo:
git commit -m 'iniciando o projeto. VAMOS COM TUDO :rocket:'
(fazendo o primeiro commit)git status
(deve aparecer uma mensagem tipo nothing to commit )
- Exemplo:
- Adicione a sua branch com o novo
commit
ao repositório remoto
- Usando o exemplo anterior:
git push -u origin joao-silva-playground-functions
- Crie um novo
Pull Request
(PR)
- Vá até a página de Pull Requests do repositório no GitHub
- Clique no botão verde "New pull request"
- Clique na caixa de seleção "Compare" e escolha a sua branch com atenção
- Adicione uma descrição para o Pull Request, um título que o identifique, e clique no botão verde "Create pull request". Crie da seguinte forma:
[JOAO-SILVA] Projeto Playground Functions
- Não se preocupe em preencher mais nada por enquanto!
- Volte até a página de Pull Requests do repositório e confira que o seu Pull Request está criado. 😀
-
Faça
commits
das alterações que você fizer no código regularmente. -
Lembre-se de sempre após um (ou alguns)
commits
atualizar o repositório remoto. -
Os comandos que você utilizará com mais frequência são:
git status
(para verificar o que está em vermelho - fora do stage - e o que está em verde - no stage)git add
(para adicionar arquivos ao stage do Git)git commit
(para criar um commit com os arquivos que estão no stage do Git)git push
(para enviar o commit para o repositório remoto após o passo anterior)git push -u nome-da-branch
(para enviar o commit para o repositório remoto na primeira vez que fizer opush
de uma nova branch)
Para garantir a qualidade do seu código de forma a tê-lo mais legível, de mais fácil manutenção e seguindo as boas práticas de desenvolvimento nós utilizamos neste projeto o linter ESLint
. Para rodar o linter localmente no seu projeto, execute o comando abaixo:
npm run lint
⚠ NESTE PROJETO O ESLINT NÃO SERÁ AVALIADO. VOCÊ PODE RODAR O TESTE LOCALMENTE E FAZER AS CORREÇÕES SE DESEJAR! MAS SÓ APÓS TER ENTREGUE 100% DOS REQUISITOS 😉 ⚠
- Os requisitos do seu projeto são avaliados automaticamente
Para verificar se a sua avaliação foi computada com sucesso, você pode verificar os detalhes da execução do avaliador.
-
Na página do seu Pull Request, acima do "botão de merge", procure por "Evaluator job" e clique no link "Details";
-
Na página que se abrirá, procure pela linha "Evaluator step" e clique nela;
-
Caso tenha dúvidas, procure as pessoas instrutoras.
Para rodar o avaliador automático localmente no seu projeto, execute um dos comandos abaixo:
Para executar todos os testes utilize:
npm test
ou
Para executar um arquivo de teste específico, utilize npm test nomeDoArquivoDeTeste
:
npm test compareTrue
O não cumprimento de um requisito, total ou parcialmente, impactará em sua avaliação.
- Para verificar se a sua função foi criada corretamente você pode instalar a extensão
code runner
no VSCode. - Utilize
console.log()
para testar as funções localmente, mas pode remover antes de fazer o push 😉.
JavaScript possui um operador lógico &&
, o qual recebe dois valores e retorna true
se ambos os valores são verdadeiros, e retorna false
se algum dos valores não o for.
Considerando isso, implemente na função compareTrue
, um código que ao receber dois parâmetros booleanos deve:
- Retornar
true
se ambos os valores forem verdadeiros; - Retornar
false
se um ou ambos os parâmetros forem falsos.
Faça a função somente utilizando o operador &&
.
O que será verificado:
-
Retorne false quando se chamar a função compareTrue com um parâmetro de valor false e outro de valor true
-
Retorne false quando se chamar a função compareTrue com dois parâmetros de valor false
-
Retorne true quando se chamar a função compareTrue com dois parâmetros de valor true
Escreva uma função com o nome calcArea
que receba um valor de base (chamado base
) e outro de altura (chamado height
) de um triângulo e retorne o cálculo da sua área.
Lembre-se que a área de um triângulo é calculada através da seguinte fórmula: (base * altura) / 2.
O que será verificado:
-
Retorne o valor 250 quando a funcão calcArea é chamada com o parâmetro base com o valor 10 e o parâmetro height com o valor 50
-
Retorne o valor 5 quando a funcão calcArea é chamada com o parâmetro base com o valor 5 e o parâmetro height com o valor 2 espera-se como resultado 5
-
Retorne o valor 25.5 quando a funcão calcArea é chamada com o parâmetro base com o valor 51 e o parâmetro height com o valor 1 espera-se como resultado 25.5
Escreva uma função com o nome splitSentence
, a qual receberá uma string e retornará uma array de strings separadas por cada espaço na string original.
Exemplo: se a função receber a string "go Trybe"
, o retorno deverá ser ['go', 'Trybe']
.
O que será verificado:
-
Retorne o valor ['go', 'Trybe'] se a função receber a string 'go Trybe'
-
Retorne o valor ['vamo', 'que', 'vamo']. se a função receber a string 'vamo que vamo'
-
Retorne o valor ['foguete'] se a função receber a string 'foguete'
Escreva uma função com o nome concatName
que, ao receber uma array de strings, retorne uma string com o formato 'ÚLTIMO ITEM, PRIMEIRO ITEM'
, independente do tamanho da array.
Isso quer dizer que, caso o parâmetro passado para concatName
seja a Array ['Lucas', 'Cassiano', 'Ferraz', 'Paolillo'], a função deverá retornar Paolillo, Lucas
.
O que será verificado:
-
Retorne 'Paolillo, Lucas' quando o parâmetro passado na funcão concatName seja ['Lucas', 'Cassiano', 'Ferraz', 'Paolillo']
-
Retorne 'ré, foguete' quando o parâmetro passado na funcão concatName seja ['foguete', 'não', 'tem', 'ré']
-
Retorne 'captain, captain' quando o parâmetro passado na funcão concatName seja ['captain', 'my', 'captain']
Escreva uma função com o nome footballPoints
que receba o número de vitórias (esse parâmetro deverá se chamar wins
) e o número de empates (esse parâmetro deverá se chamar ties
) e retorne a quantidade de pontos que o time marcou em um campeonato.
Para tanto, considere que cada vitória vale 3 pontos e cada empate vale 1 ponto.
O que será verificado:
-
Retorne 50 pontos quando o time tenha 14 vitórias e 8 empates
-
Retorne 5 pontos quando o time tenha 1 vitória e 2 empates
-
Retorne 0 pontos quando o time tenha 0 vitórias e 0 empates
Escreva uma função chamada highestCount
que, ao receber uma array de números, retorne a quantidade de vezes que o maior deles se repete.
Exemplo: caso o parâmetro de highestCount
seja uma array com valores [9, 1, 2, 3, 9, 5, 7]
, a função deverá retornar 2
, que é a quantidade de vezes que o número 9
(maior número do array) se repete.
O que será verificado:
-
Retorne 2 quando o parâmetro passado na função highestCount seja [9, 1, 2, 3, 9, 5, 7]
-
Retorne 1 quando o parâmetro passado na função highestCount seja [0, 4, 4, 4, 9, 2, 1]
-
Retorne 3 quando o parâmetro passado na função highestCount seja [0, 0, 0]
Imagine que existem dois gatos, os quais chamaremos de cat1
e cat2
, e que ambos estão caçando um mesmo rato chamado mouse
. Imagine que os animais estão em uma reta, cada um em uma posição representada por um número.
Sabendo disso, crie uma função chamada catAndMouse
que, ao receber a posição de mouse
, cat1
e cat2
, nessa ordem, calcule as distâncias entre o rato e cada um dos gatos, em seguida, retorne qual dos felinos irá alcançar o rato primeiro (aquele que estiver mais perto do rato).
Exemplo: caso o gato cat2
esteja a 2 unidades de distância do rato, e cat1
esteja a 3 unidades, sua função deverá retornar "cat2"
.
Caso os gatos estejam na mesma distância do rato, a função deverá retornar a string "os gatos trombam e o rato foge"
.
O que será verificado:
-
Retorne a string 'cat2' caso a função catAndMouse receba os parâmetros onde gato cat2 esteja a 2 unidades de distância do rato e cat1 esteja a 3 unidades de distância do rato
-
Retorne a string 'cat1' caso a função catAndMouse receba os parâmetros onde gato cat1 esteja a 6 unidades de distância do rato e cat2 esteja a 12 unidades de distância do rato
-
Retorne a string 'os gatos trombam e o rato foge' caso a função catAndMouse receba os parâmetros onde os gatos estejam na mesma distância do rato
Crie uma função chamada fizzBuzz
que receba uma array de números e retorne uma array da seguinte forma:
- Para cada número do Array que seja divisível apenas por 3, apresente uma string
"fizz"
; - Para cada número do Array que seja divisível apenas por 5, apresente uma string
"buzz"
; - Caso o número seja divisível por 3 e 5, retorne a string
"fizzBuzz"
; - Caso o número não possa ser dividido por 3 nem por 5, retorne a string
"bug!"
;
Exemplo: caso o parâmetro seja [2, 15, 7, 9, 45], sua função deverá retornar ["bug!", "fizzBuzz", "bug!", "fizz", "fizzBuzz"]
.
O que será verificado:
-
Retorne as strings ['bug!', 'fizzBuzz', 'bug!', 'fizz', 'fizzBuzz'] quando é passado os parâmetros [2, 15, 7, 9, 45] para a função fizzBuzz
-
Retorne as strings ['bug!', 'fizz'] quando é passado os parâmetros [7, 9] para a função fizzBuzz
-
Retorne as strings ['fizz', 'buzz'] quando é passado os parâmetros [9, 25] para a função fizzBuzz
Crie duas funções: a primeira deverá se chamar encode
e, ao receber uma string como parâmetro, deverá trocar todas as vogais minúsculas por números, de acordo com o formato a seguir:
a -> 1
e -> 2
i -> 3
o -> 4
u -> 5
Ou seja, caso o parâmetro de encode
seja "hi there!"
, o retorno deverá ser "h3 th2r2!"
.
A segunda função deverá se chamar decode
e faz o contrário de encode
- ou seja, recebe uma string contendo números no lugar de letras minúsculas e retornará uma string com vogais minúsculas no lugar dos números (então, caso o parâmetro de decode
seja "h3 th2r2!"
, o retorno deverá ser "hi there!"
).
O que será verificado:
-
Retorne uma string codificada quando a função encode for utilizada
-
Retorne uma string decodificada quando a função decode for utilizada
Crie uma função que recebe um array de nomes de tecnologias que você quer aprender. Essa função deve receber também um segundo parâmetro chamado name
com um nome.
Para cada tecnologia no array, crie um objeto com a seguinte estrutura:
{
tech: "NomeTech",
name: name
}
Estes objetos devem ser inseridos em uma nova lista em ordem crescente a partir do campo tech
no objeto.
A saída da sua função deve ser uma lista de objetos ordenada pelo campo tech
dos objetos com o formato acima.
Exemplo:
Entradas da função:
["React", "Jest", "HTML", "CSS", "JavaScript"]
"Lucas"
// Saída:
[
{
tech: "CSS",
name: "Lucas"
},
{
tech: "HTML",
name: "Lucas"
},
{
tech: "JavaScript",
name: "Lucas"
},
{
tech: "Jest",
name: "Lucas"
},
{
tech: "React",
name: "Lucas"
}
]
Caso o array venha vazio sua função deve retornar 'Vazio!'
O que será verificado:
-
Retorne uma lista de objetos ordenados quando é passada uma lista com 5 tecnologias
-
Retorne a mensagem de erro 'Vazio!' quando a lista não tiver tecnologias
Bônus
Crie uma função chamada generatePhoneNumber
que receba uma array com 11 números e retorne um número de telefone, respeitando parênteses, traços e espaços.
Exemplo: caso o parâmetro da função seja [1, 2, 3, 4, 5, 6, 7, 8, 9, 0, 1], generatePhoneNumber
deverá retornar (12) 34567-8901
.
-
Se a função receber um array com tamanho diferente de 11, a mesma deve retornar
"Array com tamanho incorreto."
. -
Caso algum dos números da array seja menor que 0, maior que 9 ou se repita 3 vezes ou mais,
generatePhoneNumber
deverá retornar a string"não é possível gerar um número de telefone com esses valores"
.
O que será verificado:
-
Retorne a string "Array com tamanho incorreto." caso o array tenha o tamanho diferente de 11
-
Retorne a string "não é possível gerar um número de telefone com esses valores" caso algum dos números do array seja menor que 0
-
Retorne a string "não é possível gerar um número de telefone com esses valores" caso algum número do array seja maior que 9
-
Retorne a string "não é possível gerar um número de telefone com esses valores" caso algum número do array se repetir 3 vezes ou mais
-
Retorne um número de telefone, respeitando parênteses, traços e espaços caso os números do array estejam de acordo com as especificações
Um triângulo é composto de três linhas: lineA
, lineB
e lineC
. Crie uma função chamada triangleCheck
que deverá receber as três linhas como parâmetro e retornar se é possível formar um triângulo com os valores apresentados de cada linha.
Para tanto, tenha em mente algumas considerações:
-
Para que seja possível formar um triângulo, é necessário que a medida de qualquer um dos lados seja menor que a soma das medidas dos outros dois e maior que o valor absoluto da diferença entre essas medidas.
-
Para obter o valor absoluto de um número em JavaScript, pesquise pela função
Math.abs
. -
O retorno da sua função deverá ser um booleano.
Exemplo: o retorno de triangleCheck(10, 14, 8)
deverá ser true
.
O que será verificado:
-
Retorne false quando a medida de qualquer um dos lados seja maior que a soma das medidas dos outros dois.
-
Retorne false quando a medida de qualquer um dos lados seja menor que o valor absoluto da diferença entre essas medidas.
-
Retorne true quando a medida de qualquer um dos lados seja menor que a soma das medidas dos outros dois e maior que o valor absoluto da diferença entre essas medidas.
Segundo as regras desse bar, a cada bebida deve-se beber um copo de água para que não se tenha ressaca.
Crie a função hydrate
que recebe uma string, e retorne a sugestão de quantos copos de água você deve beber. Exemplos:
String recebida:
"1 cerveja"
String retornada:
"1 copo de água"
String recebida:
"1 cachaça, 5 cervejas e 1 copo de vinho"
String retornada:
"7 copos de água"
String recebida:
"1 cachaça, 5 cervejas e 1 copo de vinho"
String retornada:
"7 copos de água"
Notas
-
Para simplificar, consideraremos que qualquer coisa com um número à frente é uma bebida e que a sua string sempre virá com o formato quantidade (em número) + tipo da bebida.
-
O número na frente de cada bebida está no intervalo entre 1 e 9.
Dica: pesquise por algo similar a get all integers inside a string js
.
O que será verificado:
- Retorne a sugestão de quantos copos de água deve-se beber ao receber uma string
Para "entregar" seu projeto, siga os passos a seguir:
- Vá até a página DO SEU Pull Request, adicione a label de "code-review" e marque outras pessoas estudantes da sua turma
- No menu à direita, clique no link "Labels" e escolha a label code-review
- No menu à direita, clique no link "Assignees" e escolha o seu usuário
- No menu à direita, clique no link "Reviewers" e digite
students
, selecione o timetryber/students-sd-016-b
Se ainda houver alguma dúvida sobre como entregar seu projeto, aqui tem um video explicativo.
Ao finalizar e submeter o projeto, não se esqueça de avaliar sua experiência preenchendo o formulário. Leva menos de 3 minutos!
Link: FORMULÁRIO DE AVALIAÇÃO DE PROJETO
O avaliador automático não necessariamente avalia seu projeto na ordem em que os requisitos aparecem no readme. Isso acontece para deixar o processo de avaliação mais rápido 😉.