One Hat Cyber Team

⚝ One Hat Cyber Team ⚝

Your IP: 216.73.216.1
Server IP: 185.238.29.86
Server: Linux server2 6.8.12-6-pve #1 SMP PREEMPT_DYNAMIC PMX 6.8.12-6 (2024-12-19T19:05Z) x86_64
Server Software: nginx/1.18.0
PHP Version: 8.1.31
Buat File | Buat Folder

Dir : ~/var/www/invoice/node_modules/collect.js/docs/api/

Edit File: firstOrFail.md

# `firstOrFail()`

The firstOrFail method returns the first element in the collection, or throws an error if there are no elements:

```js
collect([1, 2, 3, 4]).firstOrFail(item => item > 1);

// 2
```

```js
collect([1, 2, 3, 4]).firstOrFail(item => item > 4);

// Error ('Item not found.') is thrown.
```

You may also call the firstOrFail method with no arguments to get the first element in the collection. If the collection is empty, an error is thrown:

```js
collect([1, 2, 3, 4]).firstOrFail();

// 1
```

```js
collect().firstOrFail();

// Error ('Item not found.') is thrown.
```

Like the where method, you may also pass an attribute, operator, and value:

```js
const collection = collect([
  { product: 'Desk', price: 200, discounted: true },
  { product: 'Chair', price: 100, discounted: true },
  { product: 'Bookcase', price: 150, discounted: true },
  { product: 'Door', price: 100 },
]);

collection.firstOrFail('product', '=', 'Desk');

// { product: 'Desk', price: 200, discounted: true }
```

[View source on GitHub](https://github.com/ecrmnn/collect.js/blob/master/src/methods/firstOrFail.js)