{"id":20534859,"url":"https://github.com/nagilum/linqjs","last_synced_at":"2025-03-06T03:17:49.457Z","repository":{"id":150121482,"uuid":"82719639","full_name":"nagilum/linqjs","owner":"nagilum","description":"Some LINQ functionality for JavaScript Array","archived":false,"fork":false,"pushed_at":"2017-04-12T10:46:28.000Z","size":10,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-16T13:48:03.977Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nagilum.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-02-21T19:40:45.000Z","updated_at":"2017-02-21T19:41:53.000Z","dependencies_parsed_at":"2023-04-25T11:15:52.835Z","dependency_job_id":null,"html_url":"https://github.com/nagilum/linqjs","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nagilum%2Flinqjs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nagilum%2Flinqjs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nagilum%2Flinqjs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nagilum%2Flinqjs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nagilum","download_url":"https://codeload.github.com/nagilum/linqjs/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242138821,"owners_count":20078006,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-16T00:28:27.324Z","updated_at":"2025-03-06T03:17:49.449Z","avatar_url":"https://github.com/nagilum.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# linqjs\n\nSome LINQ functionality for JavaScript Array\n\nSupplies the following functions for arrays:\n\n* ```all```\n* ```any```\n* ```copy```\n* ```distinct```\n* ```first```\n* ```orderBy```\n* ```orderByDescending```\n* ```select```\n* ```skip```\n* ```take```\n* ```where```\n\nSay you have the following array:\n\n```js\nlet people = [\n  { name: 'Barack Obama', age: 55, isAlive: true, gender: 'M' },\n  { name: 'Genghis Khan', age: 65, isAlive: false, gender: 'M' },\n  { name: 'Britney Spears', age: 35, isAlive: true, gender: 'F' },\n  { name: 'Ada Lovelace', age: 36, isAlive: false, gender: 'F' },\n\n  // Yes I know she is added twice, it's for the distinct() call!\n  { name: 'Ada Lovelace', age: 36, isAlive: false, gender: 'F' }\n];\n```\n\n## all\n\nDetermines whether all elements of a sequence satisfy a condition.\n\nParam: ```Function predicate```\n\nReturns: ```boolean```\n\n---\n\nExample:\n\n```js\nlet allIsAlive = people.all(x =\u003e x.isAlive);\n```\n\nWill produce:\n\n```js\nfalse\n```\n\n## any\n\nDetermines whether any element of a sequence satisfies a condition.\n\nParam: ```Function predicate```\n\nReturns: ```boolean```\n\n---\n\nExample:\n\n```js\nlet females = people.any(x =\u003e x.gender === 'F');\n```\n\nWill produce:\n\n```js\ntrue\n```\n\n## copy\n\nMake an exact copy of the array, not a reference.\n\nParam *none*\n\nReturns: ```Array```\n\n---\n\nExample:\n\n```js\nlet copiedList = people.copy();\n```\n\nWill produce:\n\n```js\n[\n  { name: 'Barack Obama', age: 55, isAlive: true, gender: 'M' },\n  { name: 'Genghis Khan', age: 65, isAlive: false, gender: 'M' },\n  { name: 'Britney Spears', age: 35, isAlive: true, gender: 'F' },\n  { name: 'Ada Lovelace', age: 36, isAlive: false, gender: 'F' },\n  { name: 'Ada Lovelace', age: 36, isAlive: false, gender: 'F' }\n]\n```\n\n## distinct\n\nReturns distinct elements from a sequence.\n\nParam: *none*\n\nReturns: ```Array```\n\n---\n\nExample:\n\n```js\nlet distinctList = people.distinct();\n```\n\nWill produce:\n\n```js\n[\n  { name: 'Barack Obama', age: 55, isAlive: true, gender: 'M' },\n  { name: 'Genghis Khan', age: 65, isAlive: false, gender: 'M' },\n  { name: 'Britney Spears', age: 35, isAlive: true, gender: 'F' },\n  { name: 'Ada Lovelace', age: 36, isAlive: false, gender: 'F' }\n]\n```\n\n## first\n\nReturns the first element of a sequence based on a predicate, or a null if the sequence contains no elements.\nI've combined First(), FirstOrDefault(), Single(), and SingleOrDefault() into first(), and all \"fails\" just return a null.\n\nParam: ```Function predicate```\n\nReturns: ```Object```\n\n---\n\nExamples:\n\n```js\nlet khan = people.first(x =\u003e x.name.endsWith('Khan'));\n```\n\nWill produce:\n\n```js\n{ name: 'Genghis Khan', age: 65, isAlive: false, gender: 'M' }\n```\n\n---\n\n```js\nlet obama = people.first();\n```\n\nWill produce:\n\n```js\n{ name: 'Barack Obama', age: 55, isAlive: true, gender: 'M' }\n```\n\n---\n\n```js\nlet nonExisting = people.first(x =\u003e x.age === 100);\n```\n\nWill produce:\n\n```js\nnull\n```\n\n## orderBy\n\nSorts the elements of a sequence in ascending order according to a key.\n\nParam: ```string key```\n\nReturns: ```Array```\n\n---\n\nExample:\n\n```js\nlet alphabetically = people.orderBy('name');\n```\n\nWill produce:\n\n```js\n[\n  { name: 'Ada Lovelace', age: 36, isAlive: false, gender: 'F' },\n  { name: 'Ada Lovelace', age: 36, isAlive: false, gender: 'F' },\n  { name: 'Barack Obama', age: 55, isAlive: true, gender: 'M' },\n  { name: 'Britney Spears', age: 35, isAlive: true, gender: 'F' },\n  { name: 'Genghis Khan', age: 65, isAlive: false, gender: 'M' }\n]\n```\n\n## orderByDescending\n\nSorts the elements of a sequence in descending order.\n\nParam: ```string key```\n\nReturns: ```Array```\n\n---\n\nExample:\n\n```js\nlet unalphabetically = people.orderByDescending('name');\n```\n\nWill produce:\n\n```js\n[\n  { name: 'Genghis Khan', age: 65, isAlive: false, gender: 'M' },\n  { name: 'Britney Spears', age: 35, isAlive: true, gender: 'F' },\n  { name: 'Barack Obama', age: 55, isAlive: true, gender: 'M' },\n  { name: 'Ada Lovelace', age: 36, isAlive: false, gender: 'F' },\n  { name: 'Ada Lovelace', age: 36, isAlive: false, gender: 'F' }\n]\n```\n\n## select\n\nProjects each element of a sequence into a new form.\n\nParam: ```Object map```\n\nReturns: ```Array```\n\n---\n\nExample:\n\n```js\nlet firstNamesAndGender = people.select({\n  firstName: x =\u003e x.name.substr(0, x.name.indexOf(' ')),\n  gender: x =\u003e x.gender === 'M' ? 'Male' : 'Female'\n});\n```\n\nWill produce:\n\n```js\n[\n  { firstName: 'Barack', gender: 'Male' },\n  { firstName: 'Genghis', gender: 'Male' },\n  { firstName: 'Britney', gender: 'Female' },\n  { firstName: 'Ada', gender: 'Female' },\n  { firstName: 'Ada', gender: 'Female' }\n]\n```\n\n## skip\n\nBypasses a specified number of elements in a sequence and then returns the remaining elements.\n\nParam: ```int number```\n\nReturns: ```Array```\n\n---\n\nExample:\n\n```js\nlet skipped = people.skip(2);\n```\n\nWill produce:\n\n```js\n[\n  { name: 'Britney Spears', age: 35, isAlive: true, gender: 'F' },\n  { name: 'Ada Lovelace', age: 36, isAlive: false, gender: 'F' },\n  { name: 'Ada Lovelace', age: 36, isAlive: false, gender: 'F' }\n]\n```\n\n## take\n\nReturns a specified number of contiguous elements from the start of a sequence.\n\nParam: ```int number```\n\nReturns: ```Array```\n\n---\n\nExample:\n\n```js\nlet taken = people.take(2);\n```\n\nWill produce:\n\n```js\n[\n  { name: 'Barack Obama', age: 55, isAlive: true, gender: 'M' },\n  { name: 'Genghis Khan', age: 65, isAlive: false, gender: 'M' }\n]\n```\n\n## where\n\nFilters a sequence of values based on a predicate.\n\nParam: ```Function predicate```\n\nReturns: ```Array```\n\n---\n\nExample:\n\n```js\nlet wheres = people.where(x =\u003e x.age \u003e 50);\n```\n\nWill produce:\n\n```js\n[\n  { name: 'Barack Obama', age: 55, isAlive: true, gender: 'M' },\n  { name: 'Genghis Khan', age: 65, isAlive: false, gender: 'M' }\n]\n```\n\n## chains\n\nYou can chain multiple functions as they're prototypes of the Array object.\n\n---\n\nExamples:\n\n```js\nlet names = people\n  .orderBy('name')\n  .skip(2)\n  .take(2)\n  .where(x =\u003e x.age \u003c 40);\n```\n\nWill produce:\n\n```js\n[\n  { name: 'Britney Spears', age: 35, isAlive: true, gender: 'F' }\n]\n```\n\n---\n\n```js\nlet otherPerson = people\n  .where(x =\u003e !x.isAlive \u0026\u0026\n              x.gender === 'M')\n  .first();\n```\n\nWill produce:\n\n```js\n{ name: 'Genghis Khan', age: 65, isAlive: false, gender: 'M' }\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnagilum%2Flinqjs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnagilum%2Flinqjs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnagilum%2Flinqjs/lists"}