This translation is incomplete. Please help translate this article from English.

 

some() fonksiyonu, herhangi bir dizide yer alan elemanlardan en az bir tanesinin sağlanan koşulu geçip geçmediğini kontrol eder.

function isBiggerThan10(element, index, array) {
  return element > 10;
}

[2, 5, 8, 1, 4].some(isBiggerThan10);  // false
[12, 5, 8, 1, 4].some(isBiggerThan10); // true

Sözdizimi

arr.some(callback[, thisArg])

Parametreler

callback
Her bir elemanı test etmek için bir fonksiyondur. Üç adet parametre alır;
currentValue
Dizide işlenmekte olan mevcut eleman.
index (Zorunlu Değil)
Dizide işlenen geçerli öğenin sırası.
array (Zorunlu Değil)
some() fonksiyonu tarafından kullanılan array.
thisArg (Zorunlu Değil)
Bu değer zorunlu değildir. Ancak kullanılmışsa callback ya da koşul kontrolleri için this yerine bu kullanılacaktır

Dönüş Değeri

Eğer callback fonksiyon bir truthy değer dönerse, sonuç true olacaktır. Bunun dışında sonuç false olacaktır.

Açıklama

some() fonksiyonu bir her bir eleman için bir kereliğine callback fonksiyon çalıştırır. Bu işlem callback fonksiyon bir truthy değer dönene kadar çalışır (bir truthy değer, Boolean'a göre true'ya çevirilebilecek değerdir). Eğer böyle bir eleman bulunursa, some() fonksiyonu hemen true değer döndürür. Eğer şart sağlanamadıysa, some() fonksiyonu false değer döndürür. callback yalnızda değerleri atanmış olan dizi indexleri için çağrılır; silinmiş ya da hiçbir zaman atanmamış değerler için çağrılmaz..

callback üç argüman alır: Elemanın değeri, elemanın index'i ve geçiş işleminin gerçekleştiği dizi nesnesi.

If a thisArg parameter is provided to some(), it will be passed to callback when invoked, for use as its this value. Otherwise, the value undefined will be passed for use as its this value. The this value ultimately observable by callback is determined according to the usual rules for determining the this seen by a function.

some() does not mutate the array on which it is called.

The range of elements processed by some() is set before the first invocation of callback. Elements that are appended to the array after the call to some() begins will not be visited by callback. If an existing, unvisited element of the array is changed by callback, its value passed to the visiting callback will be the value at the time that some() visits that element's index; elements that are deleted are not visited.

Examples

Testing value of array elements

The following example tests whether any element in the array is bigger than 10.

function isBiggerThan10(element, index, array) {
  return element > 10;
}

[2, 5, 8, 1, 4].some(isBiggerThan10);  // false
[12, 5, 8, 1, 4].some(isBiggerThan10); // true

Testing array elements using arrow functions

Arrow functions provide a shorter syntax for the same test.

[2, 5, 8, 1, 4].some(x => x > 10);  // false
[12, 5, 8, 1, 4].some(x => x > 10); // true

Checking whether a value exists in an array

The following example returns true if the element exists in the array:

var fruits = ['apple', 'banana', 'mango', 'guava'];

function checkAvailability(arr, val) {
  return arr.some(function(arrVal) {
    return val === arrVal;
  });
}

checkAvailability(fruits, 'kela');   // false
checkAvailability(fruits, 'banana'); // true

Checking whether a value exists using an arrow function

var fruits = ['apple', 'banana', 'mango', 'guava'];

function checkAvailability(arr, val) {
  return arr.some(arrVal => val === arrVal);
}

checkAvailability(fruits, 'kela');   // false
checkAvailability(fruits, 'banana'); // true

Converting any value to Boolean

var TRUTHY_VALUES = [true, 'true', 1];

function getBoolean(a) {
  'use strict';
  
  var value = a;
   
  if (typeof value === 'string') { 
    value = value.toLowerCase().trim();
  }

  return TRUTHY_VALUES.some(function(t) {
    return t === value;
  });
}

getBoolean(false);   // false
getBoolean('false'); // false
getBoolean(1);       // true
getBoolean('true');  // true

Polyfill

some() was added to the ECMA-262 standard in the 5th edition; as such it may not be present in all implementations of the standard. You can work around this by inserting the following code at the beginning of your scripts, allowing use of some() in implementations which do not natively support it. This algorithm is exactly the one specified in ECMA-262, 5th edition, assuming Object and TypeError have their original values and that fun.call evaluates to the original value of Function.prototype.call().

// Production steps of ECMA-262, Edition 5, 15.4.4.17
// Reference: http://es5.github.io/#x15.4.4.17
if (!Array.prototype.some) {
  Array.prototype.some = function(fun/*, thisArg*/) {
    'use strict';

    if (this == null) {
      throw new TypeError('Array.prototype.some called on null or undefined');
    }

    if (typeof fun !== 'function') {
      throw new TypeError();
    }

    var t = Object(this);
    var len = t.length >>> 0;

    var thisArg = arguments.length >= 2 ? arguments[1] : void 0;
    for (var i = 0; i < len; i++) {
      if (i in t && fun.call(thisArg, t[i], i, t)) {
        return true;
      }
    }

    return false;
  };
}

Specifications

Specification Status Comment
ECMAScript 5.1 (ECMA-262)
The definition of 'Array.prototype.some' in that specification.
Standard Initial definition. Implemented in JavaScript 1.6.
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of 'Array.prototype.some' in that specification.
Standard  
ECMAScript Latest Draft (ECMA-262)
The definition of 'Array.prototype.some' in that specification.
Draft  

Browser compatibility

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support (Yes) 1.5 (1.8) 9 (Yes) (Yes)
Feature Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support (Yes) (Yes) 1.0 (1.8) (Yes) (Yes) (Yes)

See also

Document Tags and Contributors

Contributors to this page: metoikos, aligoren, exehakan
Last updated by: metoikos,