Function toBeHorizontallyAlignedWith

toBeHorizontallyAlignedWith(
    element: Locator,
    container: Locator,
    alignment: HorizontalAlignment,
    options?: ToBeHorizontallyAlignedWithOptions,
): Promise<MatcherReturnType>
Asserts that the target element is horizontally aligned with the specified container according to the given alignment type.
- Left alignment (alignment = 'left'):
```
|[element]------------------|
```
- Center alignment (alignment = 'center'):
```
|---------[element]---------|
```
- Right alignment (alignment = 'right'):
```
|------------------[element]|
```
Parameters
- element: Locator
- container: Locator
  The container element as a Locator relative to which horizontal alignment is checked.
- alignment: HorizontalAlignment
  The type of horizontal alignment to check (left, center, or right).
- options: ToBeHorizontallyAlignedWithOptions = {}
  Optional alignment options.
Returns Promise<MatcherReturnType>
A Promise that resolves with the matcher result.
Example
```
// Assert that a button is left-aligned with its card container, allowing 3% horizontal tolerance
await expect(buttonLocator).toBeHorizontallyAlignedWith(parentLocator, HorizontalAlignment.Left, {
  tolerancePercent: 3
});
```
Example
```
// Assert that a button is horizontally centered with its card container (default options)
await expect(buttonLocator).toBeHorizontallyAlignedWith(parentLocator, HorizontalAlignment.Center);
```
- Defined in matchers/horizontally-align-with.ts:106