Function toBeVerticallyAlignedWith

toBeVerticallyAlignedWith(
    element: Locator,
    container: Locator,
    alignment: VerticalAlignment,
    options?: ToBeVerticallyAlignedWithOptions,
): Promise<MatcherReturnType>
Asserts that the target element is vertically aligned with the specified container according to the given alignment type.
- Top alignment (alignment = 'top'):
```
|[element]|
|         |
|         |
```
- Center alignment (alignment = 'center'):
```
|         |
|[element]|
|         |
```
- Bottom alignment (alignment = 'bottom'):
```
|         |
|         |
|[element]|
```
Parameters
- element: Locator
- container: Locator
  The container element as a Locator relative to which vertical alignment is checked.
- alignment: VerticalAlignment
  The type of vertical alignment to check (top, center, or bottom).
- options: ToBeVerticallyAlignedWithOptions = {}
  Optional size comparison options.
Returns Promise<MatcherReturnType>
A Promise that resolves with the matcher result.
Example
```
// Check that a header is bottom-aligned with its section container, allowing a 2% vertical tolerance
await expect(headerLocator).toBeVerticallyAlignedWith(parentLocator, VerticalAlignment.Bottom, {
  tolerancePercent: 2
});
```
Example
```
// Check that a header is vertically centered within its section container (default options)
await expect(headerLocator).toBeVerticallyAlignedWith(parentLocator, VerticalAlignment.Center);
```
- Defined in matchers/vertically-align-with.ts:112