2024-07-18 15:36:32 +03:00
# startsWith
::: info
2024-08-10 11:38:07 +03:00
This function is only available in `es-toolkit/compat` for compatibility reasons. It either has alternative native JavaScript APIs or isn’ t fully optimized yet.
When imported from `es-toolkit/compat` , it behaves exactly like lodash and provides the same functionalities, as detailed [here ](../../../compatibility.md ).
2024-07-18 15:36:32 +03:00
:::
Checks if a string contains another string at the beginning of the string.
Checks if one string startsWith another string. Optional position parameter to start searching from a certain index.
## Signature
```typescript
function startsWith(str: string, target: string, position: number = 0): string;
```
### Parameters
- `str` (`string`): The string that will be searched.
- `target` (`string`): The string that it should contain at the start.
2024-08-25 15:57:59 +03:00
- `position` (`number`, optional): The offset to start searching in the str string.
2024-07-18 15:36:32 +03:00
### Returns
(`boolean`) Whether or not the str string starts with the target string
## Examples
```typescript
2024-09-26 04:53:52 +03:00
import { startsWith } from 'es-toolkit/compat';
2024-07-18 15:36:32 +03:00
2024-08-10 11:38:07 +03:00
startsWith('fooBar', 'foo'); // returns true
startsWith('fooBar', 'Bar'); // returns false
startsWith('fooBar', 'abcdef'); // returns false
startsWith('fooBar', 'Bar', 3); // returns true
2024-07-18 15:36:32 +03:00
```