Change the stackAllItems option to be false by default

readme.md

@@ -939,7 +939,7 @@ Default: [`Link` header logic](source/index.ts)
 
 The function takes an object with the following properties:
 - `response` - The current response object.
-- `allItems` - An array of the emitted items.
+- `allItems` - An array of the emitted items if [pagination.stackAllItems](#pagination.stackAllItems) is set to `true`. An empty array otherwise.
 - `currentItems` - Items from the current response.
 
 It should return an object representing Got options pointing to the next page. The options are merged automatically with the previous request, therefore the options returned `pagination.paginate(...)` must reflect changes only. If there are no more pages, `false` should be returned.
@@ -1022,11 +1022,11 @@ For example, it can be helpful during development to avoid an infinite number of
 ###### pagination.stackAllItems
 
 Type: `boolean`\
-Default: `true`
+Default: `false`
 
-Defines how the parameter `allItems` in [pagination.paginate](#pagination.paginate), [pagination.filter](#pagination.filter) and [pagination.shouldContinue](#pagination.shouldContinue) is managed. When set to `false`, the parameter `allItems` is always an empty array.
+Defines how the parameter `allItems` in [pagination.paginate](#pagination.paginate), [pagination.filter](#pagination.filter) and [pagination.shouldContinue](#pagination.shouldContinue) is managed. When set to `true`, the parameter `allItems` is an of the emitted items.
 
-This option can be helpful to save on memory usage when working with a large dataset.
+When set to `false`, the parameter `allItems` is always an empty array. This option can be helpful to save on memory usage when working with a large dataset.
 
 ##### localAddress
 

source/as-promise/types.ts

@@ -46,7 +46,7 @@ export interface PaginationOptions<ElementType, BodyType> {
 		/**
 		The function takes an object with the following properties:
 		- `response` - The current response object.
-		- `allItems` - An array of the emitted items.
+		- `allItems` - An array of the emitted items if `pagination.stackAllItems` is set to `true`. An empty array otherwise.
 		- `currentItems` - Items from the current response.
 
 		It should return an object representing Got options pointing to the next page.
@@ -127,9 +127,9 @@ export interface PaginationOptions<ElementType, BodyType> {
 
 		/**
 		Defines how the parameter `allItems` in pagination.paginate, pagination.filter and pagination.shouldContinue is managed.
-		When set to `false`, the parameter `allItems` is always an empty array.
+		When set to `true`, the parameter `allItems` is an of the emitted items.
 
-		This option can be helpful to save on memory usage when working with a large dataset.
+		When set to `false`, the parameter `allItems` is always an empty array. This option can be helpful to save on memory usage when working with a large dataset.
 		*/
 		stackAllItems?: boolean;
 	};

source/index.ts

@@ -113,7 +113,7 @@ const defaults: InstanceDefaults = {
 			countLimit: Number.POSITIVE_INFINITY,
 			backoff: 0,
 			requestLimit: 10000,
-			stackAllItems: true
+			stackAllItems: false
 		},
 		parseJson: (text: string) => JSON.parse(text),
 		stringifyJson: (object: unknown) => JSON.stringify(object),