![](\"\/img\/articles\/object-groupby.png\"\/)
<\/p>\n<\/p>\n
The introduction of Object.groupBy<\/a> allows for a streamlined, native approach to organizing collections of data based on user defined criterion; thus simplifying the task of data analysis and categorization without the need for managing third-party dependencies.<\/p>\n Using For example, we can group employees by department as follows:<\/p>\n \n Example 1<\/a>\n<\/p>\n In the above example, we see that the provided array can easily be grouped into specific properties, in this case, by department. We can just as easily have grouped the array by any other property as well, such as date of hire (doh) to categories by employee tenure (more on this shortly<\/a><\/em> ). <\/p>\n Indeed, \n Example 2<\/a>\n<\/p>\n While the above examples are useful in their own right, the real power of \n Example 3<\/a>\n<\/p>\n New features such as `Object.groupBy` serve to highlight the TC39 Committee's<\/a> commitment to providing developers with powerful tools which simplify common tasks. By introducing a native facility for grouping objects, Update: The introduction of Object.groupBy allows for a streamlined, native approach to organizing collections of data based on user defined criterion; thus simplifying the task of data analysis and categorization without the need for managing third-party dependencies. Using Object.groupBy Using Object.groupBy is simple and straight-forward. If you have previously used Lodash groupBy, then you are already familiar with it’s API. Object.groupBy… Continue Reading<\/a><\/p>\n","protected":false},"author":1,"featured_media":8378,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"jetpack_post_was_ever_published":false,"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":true,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":false,"jetpack_social_options":{"image_generator_settings":{"template":"highway","enabled":false}}},"categories":[42,246,78,45],"tags":[261,68,364,365],"class_list":["post-8315","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-apis","category-es6","category-javascript-2","category-refactoring","tag-es6","tag-javascript","tag-object-groupby","tag-tc39"],"jetpack_publicize_connections":[],"aioseo_notices":[],"jetpack_featured_media_url":"https:\/\/i0.wp.com\/www.ericfeminella.com\/blog\/wp-content\/uploads\/2018\/07\/object-groupby.png?fit=718%2C320&ssl=1","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/www.ericfeminella.com\/blog\/wp-json\/wp\/v2\/posts\/8315","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.ericfeminella.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.ericfeminella.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.ericfeminella.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.ericfeminella.com\/blog\/wp-json\/wp\/v2\/comments?post=8315"}],"version-history":[{"count":0,"href":"https:\/\/www.ericfeminella.com\/blog\/wp-json\/wp\/v2\/posts\/8315\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.ericfeminella.com\/blog\/wp-json\/wp\/v2\/media\/8378"}],"wp:attachment":[{"href":"https:\/\/www.ericfeminella.com\/blog\/wp-json\/wp\/v2\/media?parent=8315"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.ericfeminella.com\/blog\/wp-json\/wp\/v2\/categories?post=8315"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.ericfeminella.com\/blog\/wp-json\/wp\/v2\/tags?post=8315"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}\n Using Object.groupBy<\/a>
\n<\/h2>\nObject.groupBy<\/code> is simple and straight-forward. If you have previously used Lodash groupBy<\/a>, then you are already familiar with it’s API. Object.groupBy<\/code> accepts an array and a callback function which defines the grouping logic, and returns an object of groupings based on the callback function’s returned key<\/code>.<\/p>\n\nconst employees = [\n {id: 123, department: 'Engineering', name: 'John Doe', doh: '12\/22\/20'},\n {id: 321, department: 'Product', name: 'Jane Smith', doh: '06\/12\/19'},\n {id: 213, department: 'Product', name: 'Fred Jones', doh: '03\/13\/12'},\n {id: 312, department: 'Engineering', name: 'Kim Tyler', doh: '12\/19\/21'},\n];\nconst departments = Object.groupBy(employees,({department}) => department);\nconsole.log(departments);\n\/\/ {\n\/\/ Engineering: [\n\/\/ {id: 123, department: 'Engineering', name: 'John Doe', ...},\n\/\/ {id: 312, department: 'Engineering', name: 'Kim Tyler', ...}\n\/\/ ],\n\/\/ Product: [\n\/\/ {id: 321, department: 'Product', name: 'Jane Smith', ...},\n\/\/ {id: 213, department: 'Product', name: 'Fred Jones', ...}\n\/\/ ]\n\/\/ }\n<\/pre>\nObject.groupBy<\/code> is particularly useful for grouping collections of objects; however, it is not restricted to objects alone, it can also be used to create grouping primitives as well: <\/p>\n\nconst values = [true, false, true, true, false];\nconst {enabled, disabled} = Object.groupBy(\n values, value => value ? 'enabled' : 'disabled'\n);\nconsole.log(enabled.length); \/\/ 3\nconsole.log(disabled.length); \/\/ 2\n<\/pre>\nObject.groupBy<\/code> is revealed when more complex logic is required for determining groupings. For example, we can group the employees<\/code> array by tenure as follows: <\/p>\n\nconst employees = [\n {id: 123, department: 'Engineering', name: 'John Doe', doh: '12\/22\/20'},\n {id: 321, department: 'Product', name: 'Jane Smith', doh: '06\/12\/19'},\n {id: 213, department: 'Product', name: 'Fred Jones', doh: '03\/13\/12'},\n {id: 312, department: 'Engineering', name: 'Kim Tyler', doh: '12\/19\/21'},\n];\n\nconst groupByTenure = (employees, target) => {\n const year = (1000 * 60 * 60 * 24 * 365.25);\n return Object.groupBy(employees,({doh}) => {\n const tenure = (target - new Date(doh)) \/ year;\n return (\n tenure > 1 ? (\n tenure <= 2 ? 'development' : 'retention'\n ) : 'onboarding'\n )\n })\n};\n\nconsole.log(\n groupByTenure(employees, new Date('11\/28\/22'))\n);\n\/\/ {\n\/\/ \"development\": [{\n\/\/ \"id\": 123,\n\/\/ \"department\": \"Engineering\",\n\/\/ \"name\": \"John Doe\",\n\/\/ \"doh\": \"12\/22\/20\"\n\/\/ }],\n\/\/ \"retention\": [{\n\/\/ \"id\": 321,\n\/\/ \"department\": \"Product\",\n\/\/ \"name\": \"Jane Smith\",\n\/\/ \"doh\": \"06\/12\/19\"\n\/\/ }, {\n\/\/ \"id\": 213,\n\/\/ \"department\": \"Product\",\n\/\/ \"name\": \"Fred Jones\",\n\/\/ \"doh\": \"03\/13\/12\"\n\/\/ }],\n\/\/ \"onboarding\": [{\n\/\/ \"id\": 312,\n\/\/ \"department\": \"Engineering\",\n\/\/ \"name\": \"Kim Tyler\",\n\/\/ \"doh\": \"12\/19\/21\"\n\/\/ }]\n\/\/ }\n<\/pre>\n\n Concluding Thoughts<\/a>
\n<\/h2>\nObject.groupBy<\/code> simplifies overhead and maintainability while also opening up new opportunities for native data aggregation and analysis.<\/p>\n