You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

44 lines
2.5 KiB

Dev 3747 new exercise about handling different http request methods (#1624) * docs(piscine-js): add description for the subject uninvited * docs(uninvited.mjs): modify name in example * docs(uninvited): modify example * test(uninvited_test): add preliminary tests * fix(uninvited_test): export variable tests * chore(uninvited): run prettier * test(uninvited): write test to check for invalid status code * test(uninvited): write test to check for invalid content type * chore(uninvited): prettier * test(uninvited): add test to check if server failed * test(uninvited): export tests * test(uninvited): freeze tests to avoid tampering * test(uninvited): remove unused import * test(uninvited): remove unused parameter * test(uninvited): catch rejected promise * test(uninvited): return boolean with result of creating file * test(uninvited): fail if trying to write to an existing file, add flag * test(uninvited): write test to check file is created * test(uninvited): fix wrong path * test(uninvited): rename function for accuracy * test(uninvited): dry code * test(uninvited): rename functions for consistency * test(uninvited): test request body on success * test(uninvited): kill server before if statement * docs(uninvited): rephrase for conciseness * debug(uninvited): Working up to test 4 * test(uninvited): working tests for the subject * chore(uninvited): prettier * chore(uninvited): clean-up, remove extra lines and redundant parameter * tests(uninvited): replace undefined by constant value * test(uninvited): add test to check content of file * chore(uninvited): remove redundant assignment * fix(uninvited): remove yarn.lock * chore(uninvited): remove console log * docs(uninvited): specify what to do when the file already exists * fix(uninvited): revert gitignore * fix(test): restore unused import * docs(uninvited): add link on how to read POST data from a request * docs(uninvited): remove mention to alcohol * test(uninvited): remove unused import * fix(gitignore): add new line at end of file * docs(uninvited): make example more neutral
2 years ago
## uninvited
### Instructions
When you started to organize the party you thought it would be easier. Your friend who started helping on the last exercise, raised a question that you didn't think about before. What would happen if people showed up with a plus-one? Or a plus-three?
Oh no! You didn't take into account people uninvited who might come with your guests.
For now, what your friend suggested is to call the guests and try to find out who would come with company.
Create an `uninvited.mjs` program that will open a server to remotely not just access, but also update the list. It will need to handle http `POST` requests to add new guests.
Here below are your program/server's expected behaviors:
- It has to listen on port `5000` and it will have to print a simple message on the console, specifying the listening port.
- Its HTTP response should contain a coherent status code depending on the handling of the received HTTP request. More specifically, your server should be able to respond with the following status codes: `201` and `500`.
- The responses will always be JSON and this information should be explicit in the HTTP response.
- For each http `POST` request, your program should create the corresponding JSON file and store the contents of the body, and then provide the content as JSON in the HTTP response, if possible. If the file already exists, it should replace it.
- If for any reason the server fails, the response should be an object with a key `error` and its value `server failed`.
### Example
To test your program, you should be able to expect the following behaviour once your program is up and running.
```shell
curl -X POST localhost:5000/Ronaldinho -H "Content-Type: application/json" -d '{"answer": "yes", "drink": "guarana", "food": "chicken stroganoff"}'
{
"answer": "yes",
"drink": "guarana",
"food": "chicken stroganoff"
}
```
### Notions
- [HTTP protocol](https://developer.mozilla.org/en-US/docs/Web/HTTP)
- [HTTP Status Codes](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status)
- [Node http package: createServer](https://nodejs.org/en/knowledge/HTTP/servers/how-to-create-a-HTTP-server/)
- [How to read POST data](https://nodejs.org/en/knowledge/HTTP/servers/how-to-read-POST-data/)
### Provided files
Download [`guests.zip`](../tell-me-how-many/resources/guests.zip) to have at your disposal the `guests` directory containing the files with the guests information. You must save it in your `uninvited` exercise directory to test your program on it.