{"id":6910,"date":"2023-04-14T09:07:46","date_gmt":"2023-04-14T02:07:46","guid":{"rendered":"https:\/\/www.briswell-vn.com\/?p=6910"},"modified":"2023-04-14T09:07:46","modified_gmt":"2023-04-14T02:07:46","slug":"postman-va-mot-so-tinh-nang-huu-ich","status":"publish","type":"post","link":"https:\/\/www.briswell-vn.com\/en\/news\/postman-va-mot-so-tinh-nang-huu-ich\/","title":{"rendered":"POSTMAN AND USEFUL FEATURES"},"content":{"rendered":"

<\/p>\n

Since its first release in 2012, POSTMAN has gained over 25 million users for nearly a decade and has become the most popular tool used in API (Application Programming Interface<\/strong>) testing.<\/p>\n

POSTMAN has various features, including the ability to send HTTP requests using methods such as POST, PUT, GET, and DELETE, to check returned data in formats such as JSON and XML, to manage requests using the Collection feature, and to share data with the Import \/ Export feature. It is designed to be user-friendly and can be used by individuals without programming knowledge.<\/p>\n

After a long time working with the basic features, you may also want to learn more advanced features of POSTMAN. If so, you should not miss the helpful information shared by Briswell Vietnam in this article.<\/p>\n

1. Install POSTMAN<\/h2>\n

As an open-source tool, you can easily download and install it from the following link.<\/p>\n

POSTMAN Homepage: https:\/\/www.POSTMAN.com\/downloads\/<\/a><\/p>\n

2. Useful Features<\/h2>\n

In addition to the basic features listed at the beginning of the article, POSTMAN also provides some advanced features as follows.<\/p>\n

2.1 Set Variable<\/h3>\n

2.1.1 Why should we use variables?<\/h4>\n

When working on requests within the same project, multiple values are often commonly used and repeatedly declared, such as domain names in URLs and Authorization values.<\/p>\n

If the domain name changes or the Authorization value is updated to a new value, it is necessary to update the new value for each request, which can be time-consuming and prone to errors. As an example, during phase 1, the site’s URL is set to https:\/\/api-example1.com\/. However, in phase 2, the site’s URL is changed to https:\/\/api-example2.com\/. This would require a considerable amount of time to update the new domain name for all requests.<\/p>\n

To solve this problem, POSTMAN provides five types of variables with different ranges, which include Global variables, Collection variables, Environment variables, Data variables and Local variables. By using a variable, when you need to update information such as the domain names in the URLs or Authorization values, simply access the variable’s declared location and update the new value for the variable to call it. All requests with the current value are automatically updated to the latest value.<\/p>\n

This article describes how to declare variables within the scope of a Collection (other variables are declared in the same way). In other words, a variable declared within a Collection is only valid within that Collection and its requests.<\/p>\n

2.1.2 Declare variables in POSTMAN Collection<\/h4>\n

Step 1: Click the three dots icon (\u30fb\u30fb\u30fb) to the right of the Collection<\/strong> name and select Edit<\/strong>.
\nStep 2: In the Edit Collection<\/strong> dropdown menu, select the Variables<\/strong> tab.
\nStep 3: In the VARIABLE<\/strong> column, enter the name of the variable you want to declare.
\nStep 4: In the CURRENT VALUE<\/strong> column, assign a value to the variable.
\nStep 5: Press the Save<\/strong> button.<\/p>\n

\"\"<\/p>\n

2.1.3 Call variable in Request<\/h4>\n

Step 1: Open the file Request<\/strong>.
\nStep 2: Call the variable using the format {{variable_name}}<\/code><\/span>
\nStep 3: Press the Save<\/strong> button.<\/p>\n

\"\"<\/p>\n

2.2 Console window<\/h3>\n

Normally, we check the returned value on the Body<\/strong> tab. However, for requests with a large number of parameters, it can be difficult to see the results in the Body<\/strong> tab as we need to scroll down many times to check the information below. To solve this problem, we can use the console.log(pm.response.json())<\/code><\/span> <\/span> statement to print the returned value to the Console<\/strong> window and check if it’s there.<\/p>\n

2.2.1 Print the returned value to the Console window using the statement console.log(pm.response.json()).<\/h4>\n

Step 1: Click on the Console<\/strong> icon in the bottom left corner of the screen to open the Console<\/strong> window.
\nStep 2: Select the Tests<\/strong> tab.
\nStep 3: Write the console.log(pm.response.json())<\/code> <\/span>statement.
\nStep 4: Press the Send<\/strong> button.
\nStep 5: View the returned information printed in the Console<\/strong> window.
\nStep 6: To delete the printed information, click the Clear<\/strong> button in the right corner of the Console<\/strong> window.<\/p>\n

\"\"<\/p>\n

2.2.2 About the statement console.log(pm.response.json()).<\/h4>\n

The statement console.log(pm.response.json())<\/code><\/span> is composed of two components as follows:
\n\u30fbconsole.log()<\/code><\/span>: a function used to print the value of the object being called.
\n\u30fbpm.response.json()<\/code><\/span>: a syntax defined by POSTMAN to extract the information returned in the body.<\/p>\n

Example 1: The Response Body is an object, and we want to print out all the information returned in the body.<\/strong>
\n\u2192 Let’s use the statement console.log(pm.response.json())<\/code>.<\/p>\n

\"\"<\/p>\n

Example 2: The Response Body is an array, and we want to print out all the information returned in the body.<\/strong>
\n\u2192 Let’s use the statement console.log(pm.response.json())<\/code>.<\/p>\n

\"\"<\/p>\n

Example 3: The Response Body is an array, and we want to print only the information of the first object in that array.<\/strong>
\nIn terms of the number and nature of response parameters, the objects in an array are equivalent, so it is only necessary to check the representation of one object.
\n\u2192 Let’s use the statement console.log(pm.response.json()[0])<\/code>.<\/p>\n

\"\"<\/p>\n

Example 4: The Response Body is an object, and we want to print the value of a specific response parameter in that object.<\/strong>
\n\u2192 Let’s use the statement console.log(pm.response.json().{response parameter name})<\/code>.<\/p>\n

\"\"<\/p>\n

2.3 Introduce the Script used to test the response parameter<\/h3>\n

For Search APIs, it is common to encounter scenarios where there is an extra or missing response parameter returned as compared to the response parameter specified in the API specification. In such cases, we can use the following script to verify if the response parameter returned from the API matches the response parameters specified in the design in object units.<\/p>\n

let expectedKeys = []\r\nlet returnKeys = Object.keys(pm.response.json())\r\nfunction checkReturnKeys(expectedKeys,returnKeys){\r\n    let duplicatedExpectedKeysAray = expectedKeys.filter((item,index) => {\r\n        return expectedKeys.indexOf(item) !== index})\r\n    if (duplicatedExpectedKeysAray.length === 0) {\r\n        let missExpectedKeys = expectedKeys.filter((item) => !returnKeys.includes(item))\r\n        let redundantExpectedKeys = returnKeys.filter((item) => !expectedKeys.includes(item))\r\n        if(!_.isEqual(expectedKeys,returnKeys)){\r\n            if(missExpectedKeys.length !== 0 && redundantExpectedKeys.length !== 0){\r\n                console.log('Some parameters that are described in the specification are not being returned in the API response result, such as: '+missExpectedKeys+'. Please check again.')\r\n                console.log('Some parameters are being returned in the API response result that are not described in the specification, such as: '+redundantExpectedKeys+'. Please check again.')\r\n            }else if(missExpectedKeys.length !== 0){\r\n                console.log('Some parameters that are described in the specification are not being returned in the API response result, such as: '+missExpectedKeys+'. Please check again.')\r\n            }else{\r\n                console.log('Some parameters are being returned in the API response result that are not described in the specification, such as: '+redundantExpectedKeys+'. Please check again.')\r\n            }\r\n            return false;\r\n        }else{\r\n            console.log('The parameters returned from the API match those described in the specification.')\r\n            return true;\r\n        }\r\n    }else{\r\n        console.log('The expectedKeys array contains elements with duplicate names, such as: '+ duplicatedExpectedKeysAray+'. Please check again.')\r\n    }\r\n}\r\npm.test(\"Check return keys\", () => {\r\n    pm.expect(checkReturnKeys(expectedKeys.sort(),returnKeys.sort())).eql(true);\r\n});<\/pre>\n
2.3.1 How the above script works?<\/h4>\n
\u30fbIn the first line: let expectedKeys = []<\/code><\/span>
\n\u2192 The expectedKeys<\/strong> is an array that contains the response parameter name elements extracted from the API specification (Expected Result<\/strong>).
\n\u30fbIn the second line: let returnKeys = Object.keys(pm.response.json())<\/code><\/span>
\n\u2192 The returnKeys<\/strong> is an array that contains the response parameter name elements returned by executing API (Actual Result<\/strong>).
\n\u30fbThe script compares the elements of the expectedKeys<\/strong> array (Expected Result<\/strong>) with the returnKeys<\/strong> array (Actual Result<\/strong>).
\n\u2192 If the two arrays match completely, the script returns a PASS<\/span> <\/strong>result in the Test Results<\/strong> and a notification message in the Console<\/strong> tab.
\n\u2192 If there is no match, the script returns a FAIL<\/span><\/strong> result in the Test Results<\/strong> tab and a notification message in the Console <\/strong>tab.
\nTherefore, the following steps should be done before running the above script:
\n\u30fbOn the first line, copy and paste the response parameter names extracted from the API specification into the empty brackets []<\/code> to create the expectedKeys array.
\n\u30fbOn the second line, modify pm.response.json()<\/code> to retrieve the response parameter names returned by executing the API and creating the returnKeys array.<\/p>\n
2.3.2 Execution steps<\/h4>\n
Step 1<\/strong>: Paste the above script into the Tests<\/strong> tab on POSTMAN.<\/p>\n
\"\"<\/p>\n
 <\/p>\n
Step 2<\/strong>: Open the API specification and extract the names of the response parameters for the object that needs to be tested in the response section.
\nFor example, the autoDisplaySearchId API has a main object as “autoDisplay” and child objects such as “material”, “laminate”, etc.
\nThe illustration below is a guide to extracting the response parameter for the main object, which is autoDisplay.<\/p>\n
\"\"<\/p>\n
Step 3<\/strong>: Paste the response parameter name extracted in step 2 into []<\/code> in the first line of the above script.
\nExample:
\nBefore pasting: let expectedKeys = []<\/code>
\nAfter pasting:
\nlet expectedKeys = [\"id\",\"type\",\"code\",\"name\",\"width1\",\"width2\",\"paste\",\"unit\",\"laminateType\",<\/code>
\n\"sort\",\"supplier\",\"maker\",\"settingDate\",\"beforeUnit\",\"comment\",\"disableFlag\",\"createdAt\",\"createdBy\",<\/code>
\n\"createdUserName\",\"updatedAt\",\"updatedBy\",\"updatedUserName\"]<\/code><\/p>\n
\"\"<\/p>\n
Step 4<\/strong>: In the second line of the above script, modify returnKeys = Object.keys(pm.response.json())<\/code> to match the response parameter names returned by the API for the object being tested.<\/p>\n
Example 1<\/strong>: The autoDisplaySearchId API returns an object. If the object to be tested is the “autoDisplay” object of the autoDisplaySearchId API, modify returnKeys = Object.keys(pm.response.json())<\/code><\/p>\n
Example 2<\/strong>: The autoDisplaySearchId API returns an object. If the object to be tested is the “material” object of the autoDisplaySearchId API, modify returnKeys = Object.keys(pm.response.json().material)<\/code><\/p>\n
Example 3<\/strong>: The autoDisplaySearch API returns an array. If the object to be tested is the “autoDisplay” object of the autoDisplaySearch API, modify returnKeys = Object.keys(pm.response.json()[0])<\/code><\/p>\n
Example 4<\/strong>: The autoDisplaySearch API returns an array. If the object to be tested is the “material” object of the autoDisplaySearch API, modify returnKeys = Object.keys(pm.response.json()[0].material)<\/code><\/p>\n
Press the Send<\/strong> button to send the request and then check the PASS<\/span> <\/strong>\/ FAIL<\/strong><\/span> results in the Test Results<\/strong> tab and confirm the notification message in the Console<\/strong> tab.<\/p>\n
Case 1<\/strong>: If the elements in the expectedKeys<\/strong> array and the returnKeys<\/strong> array match, the API returns the correct parameters according to the API specification without any missing or extra parameters.
\n\u30fbTab Test Results: Display PASS<\/strong> <\/span>result.
\n\u30fbTab Console: Display the following message.
\n\"The parameters returned from the API match those described in the specification.\"<\/span><\/code><\/p>\n
\"\"<\/p>\n
Case 2<\/strong>: The expectedKeys<\/strong> array contains the element with the same name.
\n\u30fbTab Test Results: Display FAIL<\/span> <\/strong>result.
\n\u30fbTab Console: Display the following message.
\n\"The expectedKeys array contains elements with duplicate names, such as: {the same name element}. Please check again.\"<\/span><\/code>
\n\u2192 In this case, we need to check the expectedKeys<\/strong> array and remove any duplicates. After removing the duplicates, we can run the API again.<\/p>\n
\"\"<\/p>\n
Case 3<\/strong>: The API is returning the extra parameters that are not described in the API specification.
\n\u30fbTab Test Results: Display FAIL<\/span> <\/strong>result.
\n\u30fbTab Console: Display the following message.
\n\"Some parameters are being returned in the API response result that are not described in the specification, such as: {parameter name}. Please check again.\"<\/span><\/code>
\n\u2192 In this case, we need to notify the developer to delete the extra parameters.<\/p>\n
\"\"<\/p>\n
Case 4<\/strong>: Do not return response parameters described in API specification.
\n\u30fbTab Test Results: Display FAIL<\/span> <\/strong>result.
\n\u30fbTab Console: Display the following message.
\n\"Some parameters that are described in the specification are not being returned in the API response result, such as: {parameter name}. Please check again.\"<\/span><\/code>
\n\u2192 In this case, we need to notify the developer to add the missing parameters.<\/p>\n
\"\"<\/p>\n
Case 5<\/strong>: Returns both missing and extra response parameters compared to the API specification.
\n\u30fbTab Test Results: Display FAIL<\/strong> <\/span>result.
\n\u30fbTab Console: Display the following message.
\n\"Some parameters are being returned in the API response result that are not described in the specification, such as: {parameter name}. Please check again.\"<\/span><\/code>
\n\"Some parameters that are described in the specification are not being returned in the API response result, such as: {parameter name}. Please check again.\"<\/span><\/code>
\n\u2192 In this case, we need to notify the developer to delete the extra parameter and add the missing parameter.<\/p>\n
\"\"<\/p>\n
3. References<\/h2>\n
https:\/\/learning.postman.com\/docs\/sending-requests\/variables\/<\/p>\n
https:\/\/giangtester.com\/category\/api-testing\/postman\/<\/p>","protected":false},"excerpt":{"rendered":"
Since its first release in 2012, POSTMAN has gained over 25 million users for nearly a decade and has become the most popular tool used in API (Application Programming Interface) testing. POSTMAN has various features, including the ability to send HTTP requests using methods such as POST, PUT, GET, and DELETE, to check returned data in formats such as JSON and XML, to manage requests […]<\/p>\n","protected":false},"author":2,"featured_media":7363,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_mi_skip_tracking":false,"footnotes":""},"categories":[4,71],"tags":[],"class_list":["post-6910","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-news","category-it-tec"],"_links":{"self":[{"href":"https:\/\/www.briswell-vn.com\/en\/wp-json\/wp\/v2\/posts\/6910","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.briswell-vn.com\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.briswell-vn.com\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.briswell-vn.com\/en\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.briswell-vn.com\/en\/wp-json\/wp\/v2\/comments?post=6910"}],"version-history":[{"count":0,"href":"https:\/\/www.briswell-vn.com\/en\/wp-json\/wp\/v2\/posts\/6910\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.briswell-vn.com\/en\/wp-json\/wp\/v2\/media\/7363"}],"wp:attachment":[{"href":"https:\/\/www.briswell-vn.com\/en\/wp-json\/wp\/v2\/media?parent=6910"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.briswell-vn.com\/en\/wp-json\/wp\/v2\/categories?post=6910"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.briswell-vn.com\/en\/wp-json\/wp\/v2\/tags?post=6910"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}