# forInRight (Lodash 兼容性)

::: warning 使用 `Object.keys` 和 `for...in` 循环

由于需要创建键数组、反向迭代以及处理 `null` 或 `undefined`,这个 `forInRight` 函数的性能较慢。

请使用更快、更现代的 `Object.keys` 和 `for...in` 循环。

:::

按反向顺序迭代对象的所有属性(包括继承的属性),并对每个属性调用函数。

```typescript
const result = forInRight(obj, iteratee);
```

## 用法

### `forInRight(object, iteratee)`

按反向顺序迭代对象的所有属性,调用 `iteratee` 函数。它不仅迭代对象的自有属性,还包括通过原型链继承的属性。由于它将键收集到数组中然后反向迭代,因此比正常迭代慢。如果 `iteratee` 函数返回 `false`,则停止迭代。

```typescript
import { forInRight } from 'es-toolkit/compat';

// 按反向顺序迭代所有属性
const obj = { a: 1, b: 2 };
forInRight(obj, (value, key) => {
  console.log(key, value);
});
// 输出: 'b' 2, 'a' 1

// 包括继承属性的反向迭代
function Parent() {
  this.inherited = 'value';
}
Parent.prototype.protoProperty = 'proto';

const child = new Parent();
child.own = 'ownValue';

forInRight(child, (value, key) => {
  console.log(key, value);
});
// 输出: 'protoProperty' 'proto', 'own' 'ownValue', 'inherited' 'value'

// 根据条件提前终止
forInRight(obj, (value, key) => {
  console.log(key, value);
  return key !== 'a'; // 在 'a' 处停止
});
// 输出: 'b' 2, 'a' 1
```

`null` 或 `undefined` 会原样返回。

```typescript
import { forInRight } from 'es-toolkit/compat';

forInRight(null, iteratee); // null
forInRight(undefined, iteratee); // undefined
```

#### 参数

- `object` (`T | null | undefined`): 要迭代的对象。
- `iteratee` (`(value: T[keyof T], key: string, collection: T) => any`, 可选): 对每个属性调用的函数。默认为 `identity` 函数。

#### 返回值

(`T | null | undefined`): 返回原始对象。
