Common algorithms implemented in JavaScript with [Mocha](https://mochajs.org/)/[Chai](http://chaijs.com/) testing. Uses [Babel](https://babeljs.io/) and [UMD](https://github.com/umdjs/umd) to transpile algorithm modules from ES6+ to ES5. Test coverage reports are provided by [nyc](https://github.com/istanbuljs/nyc) and piped to [Coveralls](https://coveralls.io/github/sumtype/common-algorithms-js?branch=master). Coveralls reports coverage for ES6+ algorithms (although both ES6+ and transpiled ES5 algorithms are tested by [Travis-CI](https://travis-ci.org/sumtype/common-algorithms-js)). All JavaScript code follows [JavaScript Standard Style](https://standardjs.com/) guidelines. README translations are provided in the [locales](https://github.com/sumtype/common-algorithms-js/tree/master/locales) directory and translated with Google Translate. Currently [Spanish](https://github.com/sumtype/common-algorithms-js/tree/master/locales/es), [Hebrew](https://github.com/sumtype/common-algorithms-js/tree/master/locales/he), and [Chinese](https://github.com/sumtype/common-algorithms-js/tree/master/locales/zh) are available. [Contributions](https://github.com/sumtype/common-algorithms-js/blob/master/CONTRIBUTING.md) are welcome! Follow the guidelines.

Algoritmos comunes implementados en JavaScript con [Mocha](https://mochajs.org/)/[Chai](http://chaijs.com/) pruebas. Usos [Babel](https://babeljs.io/) y [UMD](https://github.com/umdjs/umd) transpilar módulos de algoritmos de ES6 + a ES5. Los informes de cobertura de las pruebas son proporcionados por [nyc](https://github.com/istanbuljs/nyc) y canalizado a [Coveralls](https://coveralls.io/github/sumtype/common-algorithms-js?branch=master). Coveralls informa sobre la cobertura de los algoritmos ES6 + (aunque los algoritmos ES6 + y ES5 transpilados se prueban mediante [Travis-CI](https://travis-ci.org/sumtype/common-algorithms-js)). Todo el código de JavaScript sigue [JavaScript Standard Style](https://standardjs.com/) pautas. Las traducciones de README se proporcionan en el [locales](https://github.com/sumtype/common-algorithms-js/tree/master/locales) directorio y traducidos con Google Translate. Actualmente [Español](https://github.com/sumtype/common-algorithms-js/tree/master/locales/es), [Hebreo](https://github.com/sumtype/common-algorithms-js/tree/master/locales/he), y [Chino](https://github.com/sumtype/common-algorithms-js/tree/master/locales/zh) están disponibles. ¡Las [contribuciones](https://github.com/sumtype/common-algorithms-js/blob/master/CONTRIBUTING.md) son bienvenidas! Siga las directrices. Siga las directrices.

אלגוריתמים נפוצים מיושמים ב- JavaScript עם בדיקות [Mocha](https://mochajs.org/)/[Chai](http://chaijs.com/). משתמש [Babel](https://babeljs.io/) ו- [UMD](https://github.com/umdjs/umd) כדי להעביר מודולי אלגוריתם מ- ES6 + ל- ES5. דוחות כיסוי הבדיקות מסופקים על ידי [nyc](https://github.com/istanbuljs/nyc) ומוצמדים אל [Coveralls](https://coveralls.io/github/sumtype/common-algorithms-js?branch=master). Coverals מדווח על כיסוי עבור אלגוריתמים של ES6+ (אם כי הן ES6+ והן אלגוריתמים ES5 transpiled נבדקים על ידי [Travis-CI](https://travis-ci.org/sumtype/common-algorithms-js). כל קוד JavaScript עוקב אחר הנחיות [JavaScript Standard Style](https://standardjs.com/). תרגומי README ניתנים בספריה [מקומות](https://github.com/sumtype/common-algorithms-js/tree/master/locales) ותורגמו באמצעות Google Translate. נכון לעכשיו [ספרדית](https://github.com/sumtype/common-algorithms-js/tree/master/locales/es), [עברית](https://github.com/sumtype/common-algorithms-js/tree/master/locales/he) ו [סינית](https://github.com/sumtype/common-algorithms-js/tree/master/locales/zh) זמינים. [תרומות](https://github.com/sumtype/common-algorithms-js/blob/master/CONTRIBUTING.md) יתקבלו בברכה! בצע את ההנחיות.

＃Contributor Covenant行为准则

##我们的承诺

为了营造一个开放和热情的环境，我们作为贡献者和维护者承诺，无论年龄，体型，残疾，种族，性别认同和表达，我们的项目和社区都可以为每个人提供无骚扰的体验，经验水平，国籍，个人形象，种族，宗教或性别认同和取向。

##我们的标准

有助于创造积极环境的行为示例包括：

*使用热情和包容的语言

*尊重不同的观点和经验

*优雅地接受建设性的批评

*专注于对社区最有利的事物

*表现出对其他社区成员的同情

参与者不可接受的行为举例包括：

*使用性化语言或图像以及不受欢迎的性关注或进步

*拖钓，侮辱/贬损评论，以及个人或政治攻击

*公开或私人骚扰

*未经明确许可，发布他人的私人信息，如物理或电子地址

*在专业环境中可合理地认为不合适的其他行为

##我们的责任

项目维护人员负责澄清可接受行为的标准，并且应该采取适当和公平的纠正措施来应对任何不可接受的行为。

项目维护者有权利和责任删除，编辑或拒绝与本“行为准则”不一致的评论，提交，代码，维基编辑，问题和其他贡献，或暂时或永久禁止其他行为的贡献者他们认为不合适，威胁，冒犯或有害。

＃＃ 范围

当个人代表项目或其社区时，本行为准则适用于项目空间和公共场所。表示项目或社区的示例包括使用官方项目电子邮件地址，通过官方社交媒体帐户发布，或作为在线或离线事件的指定代表。项目维护人员可以进一步定义和澄清项目的表示。

##执法

可以通过support@sumtype.tech联系项目团队报告滥用，骚扰或其他不可接受的行为。项目团队将审查和调查所有投诉，并以其认为适合的情况作出回应。项目团队有义务对事件记者保密。具体执行政策的进一步细节可以单独发布。

未真诚遵守或执行行为准则的项目维护人员可能会面临项目领导层其他成员所确定的暂时或永久性影响。

##归因

本行为准则改编自[贡献者契约][主页] 1.4版，可从[http://contributor-covenant.org/version/1/4][version]获取

[主页]：http：//contributor-covenant.org

[版本]：http：//contributor-covenant.org/version/1/4/

＃贡献

欢迎！请随时提供算法，问题，修复和翻译。

将算法添加到存储库有几个步骤。请记住，所有JavaScript算法和测试贡献必须遵循[JavaScript标准样式](https://standardjs.com/)规则。建议使用ES6 +代码，最好快速实现。

1）请根据所使用的驼峰式命名约定，在[ES算法目录](https://github.com/sumtype/common-algorithms-js/tree/master/algorithms/es)中创建JavaScript算法文件。该文件应遵循其他算法文件中相同的布局约定，并有一个注释标题，说明该函数的作用以及它所期望的参数。

2）按照用于添加其他的约定，将算法导出添加到[es.js](https://github.com/sumtype/common-algorithms-js/blob/master/es.js)。您需要将其添加到其类别对象并导出。请维护按字母顺序排列的组织。

3）在[ES测试目录](https://github.com/sumtype/common-algorithms-js/tree/master/test/es)中创建算法的测试文件。该文件的名称应与算法目录中的文件完全相同，但添加了后缀“Tests”。有关示例，请参阅其他测试。您的测试文件应遵循其他测试文件中的相同布局约定。应该进行测试以涵盖成功案例。失败和边缘情况以及适当的情况。

4）按照用于描述其他算法的相同约定，将新算法添加到[README.md](https://github.com/sumtype/common-algorithms-js/blob/master/README.md)。如果需要新类别的算法，请按照与其他算法相同的约定添加它。

5）**可选** - 更新[locales目录](https://github.com/sumtype/common-algorithms-js/tree/master/locales)子文件夹中的README.md文件以包含新算法（适当翻译）。

6）如果您没有更新[locales目录](https://github.com/sumtype/common-algorithms-js/tree/master/locales)中子文件夹中的README.md文件，请创建一个指定的问题需要添加新算法的区域设置翻译。

7）运行`yarn test`或`npm test`生成ES5算法版本，更新es5.js文件，ES5测试文件。查找并修复任何JavaScript标准样式错误（如果没有任何测试不会中断并将继续运行Mocha / Chai测试用例）。查看测试的覆盖率统计信息。一旦你的测试通过，你已经很好地覆盖了你的ES算法版本（> 95％，理想情况下是100％），你就可以进行提交和拉取请求了。考虑到测试环境和在转换过程中所做的更改，ES5算法的高测试覆盖率可能是不可能的。

7）根据[pull request template](https://github.com/sumtype/common-algorithms-js/blob/master/PULL_REQUEST_TEMPLATE.md)指南，从fork到master分支创建一个pull请求。

请根据[问题模板](https://github.com/sumtype/common-algorithms-js/blob/master/ISSUE_TEMPLATE.md)格式化问题。

请根据[拉取请求模板](https://github.com/sumtype/common-algorithms-js/blob/master/PULL_REQUEST_TEMPLATE.md)格式化修复请求。

要添加翻译，请按照[ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes)命名约定创建新目录。在目录中创建一个README.md文件。 README.md文件应该在格式化中准确模仿英语[README.md](https://github.com/sumtype/common-algorithms-js/blob/master/README.md)文件并准确地在翻译的内容中语言。一旦您的翻译准备就绪和/或您已完成对现有翻译的更改，请在[拉取请求模板](https://github.com/sumtype/common-algorithms-js/blob/master/PULL_REQUEST_TEMPLATE.md)之后创建拉取请求从你的fork到master分支。

修复问题＃

此拉取请求中建议的更改：