Skip to main content
Version: v6 (preview) 🚧

Should-NotContainCollection

This page was generated

Contributions are welcome in Pester-repo.

SYNOPSIS​

Checks that the expected collection is not present in the actual collection as an ordered subsequence. It does not compare the types of the input collections.

SYNTAX​

Should-NotContainCollection [[-Actual] <Object>] [-Expected] <Object> [-Because <String>] [<CommonParameters>]

DESCRIPTION​

Passes when the items of the expected collection do not appear in the actual collection in the same order. The subsequence is matched the same way as Should-ContainCollection: gaps between matched items are allowed, but each actual item is used at most once. A single value is treated as a one-item collection. Items are compared using PowerShell equality, the same as the -contains operator.

EXAMPLES​

EXAMPLE 1​

1, 2, 3 | Should-NotContainCollection @(3, 4)
1, 2, 3 | Should-NotContainCollection @(3, 2, 1)
@(1) | Should-NotContainCollection @(2)

These assertions pass, because the expected items are not present as an ordered subsequence.

EXAMPLE 2​

1, 2, 3 | Should-NotContainCollection @(1, 2)
1, 2, 3 | Should-NotContainCollection @(1, 3)
@(1) | Should-NotContainCollection @(1)

These assertions fail, because the expected items are present in the same order. Gaps between them, as in @(1, 3), are allowed.

PARAMETERS​

-Actual​

The collection to search in.

Type: Object
Parameter Sets: (All)
Aliases:

Required: False
Position: 2
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Expected​

One or more items to look for as an ordered subsequence. A single value is treated as a one-item collection.

Type: Object
Parameter Sets: (All)
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Because​

The reason why the input should be the expected value.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters​

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS​

OUTPUTS​

NOTES​

Use the -ErrorAction parameter to control soft-assertion behavior for this assertion. -ErrorAction Continue records the failure and lets the rest of the test run (a soft assertion), while -ErrorAction Stop fails the test immediately, for example to guard a precondition before continuing.

When -ErrorAction is not specified, the behavior comes from Should.ErrorAction in the configuration, which defaults to Stop. See https://pester.dev/docs/assertions/soft-assertions for more about soft assertions.

https://pester.dev/docs/commands/Should-NotContainCollection

https://pester.dev/docs/assertions

VERSION​

This page was generated using comment-based help in Pester 6.0.0-rc5.