68 lines
		
	
	
		
			2.5 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
			
		
		
	
	
			68 lines
		
	
	
		
			2.5 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
| ---
 | |
| id: 587d7fb2367417b2b2512bf6
 | |
| title: Get Query Parameter Input from the Client
 | |
| challengeType: 2
 | |
| forumTopicId: 301512
 | |
| dashedName: get-query-parameter-input-from-the-client
 | |
| ---
 | |
| 
 | |
| # --description--
 | |
| 
 | |
| Another common way to get input from the client is by encoding the data after the route path, using a query string. The query string is delimited by a question mark (?), and includes field=value couples. Each couple is separated by an ampersand (&). Express can parse the data from the query string, and populate the object `req.query`. Some characters, like the percent (%), cannot be in URLs and have to be encoded in a different format before you can send them. If you use the API from JavaScript, you can use specific methods to encode/decode these characters.
 | |
| 
 | |
| <blockquote>route_path: '/library'<br>actual_request_URL: '/library?userId=546&bookId=6754' <br>req.query: {userId: '546', bookId: '6754'}</blockquote>
 | |
| 
 | |
| # --instructions--
 | |
| 
 | |
| Build an API endpoint, mounted at `GET /name`. Respond with a JSON document, taking the structure `{ name: 'firstname lastname'}`. The first and last name parameters should be encoded in a query string e.g. `?first=firstname&last=lastname`.
 | |
| 
 | |
| **Note:** In the following exercise you are going to receive data from a POST request, at the same `/name` route path. If you want, you can use the method `app.route(path).get(handler).post(handler)`. This syntax allows you to chain different verb handlers on the same path route. You can save a bit of typing, and have cleaner code.
 | |
| 
 | |
| # --hints--
 | |
| 
 | |
| Test 1 : Your API endpoint should respond with the correct name
 | |
| 
 | |
| ```js
 | |
| (getUserInput) =>
 | |
|   $.get(getUserInput('url') + '/name?first=Mick&last=Jagger').then(
 | |
|     (data) => {
 | |
|       assert.equal(
 | |
|         data.name,
 | |
|         'Mick Jagger',
 | |
|         'Test 1: "GET /name" route does not behave as expected'
 | |
|       );
 | |
|     },
 | |
|     (xhr) => {
 | |
|       throw new Error(xhr.responseText);
 | |
|     }
 | |
|   );
 | |
| ```
 | |
| 
 | |
| Test 2 : Your API endpoint should respond with the correct name
 | |
| 
 | |
| ```js
 | |
| (getUserInput) =>
 | |
|   $.get(getUserInput('url') + '/name?last=Richards&first=Keith').then(
 | |
|     (data) => {
 | |
|       assert.equal(
 | |
|         data.name,
 | |
|         'Keith Richards',
 | |
|         'Test 2: "GET /name" route does not behave as expected'
 | |
|       );
 | |
|     },
 | |
|     (xhr) => {
 | |
|       throw new Error(xhr.responseText);
 | |
|     }
 | |
|   );
 | |
| ```
 | |
| 
 | |
| # --solutions--
 | |
| 
 | |
| ```js
 | |
| /**
 | |
|   Backend challenges don't need solutions, 
 | |
|   because they would need to be tested against a full working project. 
 | |
|   Please check our contributing guidelines to learn more.
 | |
| */
 | |
| ```
 |