Skip to content

Commit

Permalink
fix: rename global "disableCaching" to "disableGlobalCaching"
Browse files Browse the repository at this point in the history
  • Loading branch information
hasezoey committed Feb 9, 2023
1 parent 78ac3bc commit 5deb0eb
Show file tree
Hide file tree
Showing 7 changed files with 13 additions and 13 deletions.
2 changes: 1 addition & 1 deletion docs/api/decorators/modelOptions.md
Expand Up @@ -273,7 +273,7 @@ Default: `false`
Disable Caching for current Class (and all classes extending it) or for just a call (for [`buildSchema`](../functions/buildSchema.md) / [`getModelForClass`](../functions/getModelForClass.md) / [`getDiscriminatorModelForClass`](../functions/getDiscriminatorModelForClass.md)).
This Option will NOT overwrite the global [`disableCaching`](../functions/setGlobalOptions.md#disablecaching).
This Option will NOT overwrite the global [`disableGlobalCaching`](../functions/setGlobalOptions.md#disableglobalcaching) if set.
Example:
Expand Down
6 changes: 3 additions & 3 deletions docs/api/functions/setGlobalOptions.md
Expand Up @@ -27,7 +27,7 @@ The `setGlobalOptions` call has to be before any `buildSchema` (by extension als

```ts
setGlobalOptions({ options: { allowMixed: Severity.ERROR } });
setGlobalOptions({ globalOptions: { disableCaching: true } }); // does not affect the previous setting of "options"
setGlobalOptions({ globalOptions: { disableGlobalCaching: true } }); // does not affect the previous setting of "options"
setGlobalOptions({ globalOptions: { someOtherOption: true } }); // does not affect the previous setting of "globalOptions"
setGlobalOptions({ options: { disableLowerIndexes: true, allowMixed: Severity.WARN } }); // will overwrite previous setting of "allowMixed"
Expand All @@ -38,15 +38,15 @@ setGlobalOptions({ options: { disableLowerIndexes: true, allowMixed: Severity.WA
disableLowerIndexes: true
},
globalOptions: {
disableCaching: true,
disableGlobalCaching: true,
someOtherOption: true
}
}
```

## Global Typegoose Options {#options}

### disableCaching
### disableGlobalCaching

Default: `false`

Expand Down
6 changes: 3 additions & 3 deletions docs/guides/advanced/models-with-same-name.mdx
Expand Up @@ -75,15 +75,15 @@ expect(model.modelName).to.be.equal('CustomNameOption_CustomName');

## Disable Caching

Since Typegoose `10.2.0` there is also the option of disabling the cache globally with [global options](../../api/functions/setGlobalOptions.md#disablecaching) or locally via [`@modelOptions`](../../api/decorators/modelOptions.md#disablecaching).
Since Typegoose `10.2.0` there is also the option of disabling the cache globally with [`setGlobalOptions`](../../api/functions/setGlobalOptions.md)'s [`disableGlobalCaching`](../../api/functions/setGlobalOptions.md#disableglobalcaching) or locally via [`@modelOptions`](../../api/decorators/modelOptions.md#disablecaching).

<Tabs groupId="caching-global-local">
<TabItem value="global" label="Disable Cache globally">

```ts
import { setGlobalOptions } from "@typegoose/typegoose";

setGlobalOptions({ globalOptions: { disableCaching: true } });
setGlobalOptions({ globalOptions: { disableGlobalCaching: true } });

class Kitten {
@prop()
Expand Down Expand Up @@ -157,7 +157,7 @@ const KittenModelCon1 = getModelForClass(Kitten, { existingConnection: mongoose.
Models still cannot be defined more than once in the same connection / mongoose instance.
:::
:::caution
Setting the Cache to be disabled globally will make some functions that rely on it error, see [`E033`](../error-warning-details.md#cache-disabled-e033) and [`disableCaching`](../../api/functions/setGlobalOptions.md#disablecaching) which effects it will have.
Setting the Cache to be disabled globally will make some functions that rely on it error, see [`E033`](../error-warning-details.md#cache-disabled-e033) and [`disableGlobalCaching`](../../api/functions/setGlobalOptions.md#disableglobalcaching) which effects it will have.
:::

## Notes
Expand Down
2 changes: 1 addition & 1 deletion src/internal/utils.ts
Expand Up @@ -748,7 +748,7 @@ export function mapModelOptionsToNaming(options: IModelOptions | undefined): INa
* @returns "true" if caching is enabled or "false" if disabled
*/
export function isGlobalCachingEnabled(): boolean {
return !(globalOptions.globalOptions?.disableCaching === true);
return !(globalOptions.globalOptions?.disableGlobalCaching === true);
}

/**
Expand Down
2 changes: 1 addition & 1 deletion src/types.ts
Expand Up @@ -642,7 +642,7 @@ export interface ITypegooseOptions {
* "false" and "undefined" have the same result of enabling caching
* @default false
*/
disableCaching?: boolean;
disableGlobalCaching?: boolean;
}

/** Interface describing a Object that has a "typegooseName" Function */
Expand Down
4 changes: 2 additions & 2 deletions test/tests/disableCache.test.ts
Expand Up @@ -11,11 +11,11 @@ beforeEach(() => {
describe('global', () => {
beforeAll(() => {
globalOptions['globalOptions'] = globalOptions['globalOptions'] ?? {};
globalOptions['globalOptions'].disableCaching = true;
globalOptions['globalOptions'].disableGlobalCaching = true;
});

afterAll(() => {
delete globalOptions['globalOptions']!.disableCaching;
delete globalOptions['globalOptions']!.disableGlobalCaching;

mongoose.deleteModel(/.*/); // typegoose does not cache the model, but mongoose still does per connection / mongoose instance
});
Expand Down
4 changes: 2 additions & 2 deletions test/tests/errors.test.ts
Expand Up @@ -883,11 +883,11 @@ describe('tests for "DuplicateOptionsError" [E031]', () => {
describe('tests for "CacheDisabledError" [E033]', () => {
beforeAll(() => {
globalOptions['globalOptions'] = globalOptions['globalOptions'] ?? {};
globalOptions['globalOptions'].disableCaching = true;
globalOptions['globalOptions'].disableGlobalCaching = true;
});

afterAll(() => {
delete globalOptions['globalOptions']!.disableCaching;
delete globalOptions['globalOptions']!.disableGlobalCaching;
});

it('should throw a Error when trying to use "getClass" but caching is disabled', () => {
Expand Down

0 comments on commit 5deb0eb

Please sign in to comment.