--- title: String.prototype.startsWith() slug: Web/JavaScript/Reference/Global_Objects/String/startsWith translation_of: Web/JavaScript/Reference/Global_Objects/String/startsWith ---
{{JSRef}}

startsWith()
.طريقة يمكنك تحقق بها إن كان نص يبدء بالعبارة ما و تعيد لك صحيح أو خطأ

{{EmbedInteractiveExample("pages/js/string-startswith.html")}}

تركيب الجملة | Syntax

str.startsWith(searchString[, position])

المعاملات | Parameters

searchString
العبارة المبحوث عنها فيالنص.
position {{optional_inline}}
مكان الذي يبدأ البحث منه فيالنص   الإفتراضي 0

القيمة العائدة | Return value

العائد يكون صحيح إذا وجد تطابق
و إن لم يجيد تطابق يعيد لك خطأ

الوصف | Description

هذه الطريقة حساسة إتجاه الحروف
case-sensitive

أمثلة | Examples

Using startsWith()

//startswith
var str = 'To be, or not to be, that is the question.';

console.log(str.startsWith('To be'));         // true
console.log(str.startsWith('not to be'));     // false
console.log(str.startsWith('not to be', 10)); // true

Polyfill

This method has been added to the ECMAScript 2015 specification and may not be available in all JavaScript implementations yet. However, you can polyfill String.prototype.startsWith() with the following snippet:

if (!String.prototype.startsWith) {
    Object.defineProperty(String.prototype, 'startsWith', {
        value: function(search, pos) {
            pos = !pos || pos < 0 ? 0 : +pos;
            return this.substring(pos, pos + search.length) === search;
        }
    });
}

A more robust (fully ES2015 specification compliant), but less performant and compact, Polyfill is available on GitHub by Mathias Bynens.

Specifications

Specification Status Comment
{{SpecName('ES2015', '#sec-string.prototype.startswith', 'String.prototype.startsWith')}} {{Spec2('ES2015')}} Initial definition.
{{SpecName('ESDraft', '#sec-string.prototype.startswith', 'String.prototype.startsWith')}} {{Spec2('ESDraft')}}

توافق مع متصفحات

{{Compat("javascript.builtins.String.startsWith")}}

ذات صلة