From 90937a385a7c2a7aa59aa2237ead71d1fbbe7f6c Mon Sep 17 00:00:00 2001
From: merkur0 <ondramerkun123@gmail.com>
Date: Fri, 25 Oct 2019 21:59:25 +0200
Subject: [PATCH] Add documentation for Array.prototype.some()

---
 docs/JavaScript_Basics/some.md | 49 ++++++++++++++++++++++++++++++++++
 1 file changed, 49 insertions(+)
 create mode 100644 docs/JavaScript_Basics/some.md

diff --git a/docs/JavaScript_Basics/some.md b/docs/JavaScript_Basics/some.md
new file mode 100644
index 0000000..81cc05a
--- /dev/null
+++ b/docs/JavaScript_Basics/some.md
@@ -0,0 +1,49 @@
+# Array.prototype.some()
+
+This method returns true if at least one element in the array passes the test in the provided function.
+
+**Note:** This method returns false if used on an empty array.
+
+The `some` method will iterate over the elements in the given array until it finds an element that, when provided as an argument to the callback function, returns a truthy value (a value that, when converted to Boolean, becomes `true`).
+When that happens, the method stops and returns false.
+If none of the elements in the given array pass the test, this method returns false.
+
+The callback function can take up to three arguments:
+The value of the current element, it's index (optional), and the array object being traversed (optional).
+
+## Example
+
+The following code tests two differents arrays of numbers to see if any of the numbers is bigger than 10.
+
+
+```js
+function isBiggerThan10(element) {
+  return element > 10;
+}
+
+[2, 5, 8, 1, 4].some(isBiggerThan10);  // returns false
+[12, 5, 8, 1, 4].some(isBiggerThan10); // returns true
+```
+The above can also be written like this:
+
+```js
+[2, 5, 8, 1, 4].some(function(element) {
+  return element > 10;
+});  // returns false
+
+[12, 5, 8, 1, 4].some(function(element) {
+  return element > 10;
+}); // returns true
+```
+
+Or with an arrow function:
+
+```js
+[2, 5, 8, 1, 4].some((element) => {
+  return element > 10;
+});  // returns false
+
+[12, 5, 8, 1, 4].some((element) => {
+  return element > 10;
+}); // returns true
+```
\ No newline at end of file