--- title: "Django 4.1 versionsinformation" version: 5.2 locale: sv source: https://docs.djangoproject.com/sv/5.2/releases/4.1/ canonical: https://djangodocs.dev/sv/5.2/releases/4.1/ --- # Django 4.1 versionsinformation *3 augusti 2022* Välkommen till Django 4.1! Dessa versionsinformation täcker [nya funktioner](#whats-new-4-1), samt några [bakåtkompatibla ändringar](#backwards-incompatible-4-1) som du vill vara medveten om när du uppgraderar från Django 4.0 eller tidigare. Vi har [börjat utfasningsprocessen för vissa funktioner](#deprecated-features-4-1). Se guiden [Så här uppgraderar du Django till en nyare version](/sv/5.2/howto/upgrade-version/) om du ska uppdatera ett befintligt projekt. ## Kompatibilitet med Python Django 4.1 stöder Python 3.8, 3.9, 3.10 och 3.11 (från och med 4.1.3). Vi **rekommenderar** starkt och stöder endast officiellt den senaste utgåvan av varje serie. ## Vad är nytt i Django 4.1 ### Asynkrona hanterare för klassbaserade vyer View-subklasser kan nu definiera asynkrona HTTP-metodhanterare: ``` import asyncio from django.http import HttpResponse from django.views import View class AsyncView(View): async def get(self, request, *args, **kwargs): # Perform view logic using await. await asyncio.sleep(1) return HttpResponse("Hello async world!") ``` Se [Asynkrona klassbaserade visningar](/sv/5.2/topics/class-based-views/#async-class-based-views) för mer information. ### Asynkront ORM-gränssnitt `QuerySet` tillhandahåller nu ett asynkront gränssnitt för alla dataåtkomstoperationer. Dessa namnges på samma sätt som de befintliga synkrona operationerna men med prefixet `a`, till exempel `acreate()`, `aget()`, och så vidare. Det nya gränssnittet gör att du kan skriva asynkron kod utan att behöva linda in ORM-operationer i `sync_to_async()`: ``` async for author in Author.objects.filter(name__startswith="A"): book = await author.books.afirst() ``` Observera att i detta skede förblir de underliggande databasoperationerna synkrona, med bidrag som pågår för att driva asynkront stöd ner i SQL-kompilatorn och integrera asynkrona databasdrivrutiner. Det nya asynkrona queryset-gränssnittet kapslar för närvarande in de nödvändiga `sync_to_async()`-operationerna åt dig och kommer att göra det möjligt för din kod att dra nytta av utvecklingen av ORM:s asynkrona stöd när det utvecklas. Se [Asynkrona förfrågningar](/sv/5.2/topics/db/queries/#async-queries) för detaljer och begränsningar. ### Validering av begränsningar begränsningarna [`Check`](/sv/5.2/ref/models/constraints/#django.db.models.CheckConstraint), [`unique`](/sv/5.2/ref/models/constraints/#django.db.models.UniqueConstraint) och [`exclusion`](/sv/5.2/ref/contrib/postgres/constraints/#django.contrib.postgres.constraints.ExclusionConstraint) som definieras i alternativet [`Meta.constraints`](/sv/5.2/ref/models/options/#django.db.models.Options.constraints) kontrolleras nu under [modellvalidering](/sv/5.2/ref/models/instances/#validating-objects). ### Tillgänglighet för rendering av formulär För att underlätta för användare med skärmläsare och andra tekniska hjälpmedel finns nya formulärmallar baserade på\ tillgängliga från och med den här versionen. Dessa ger en mer tillgänglig navigering än de äldre mallarna och kan gruppera relaterade kontroller, t.ex. radiolistor, i fältuppsättningar på ett korrekt sätt. De nya mallarna rekommenderas och kommer att bli standardrenderingsstilen för formulär när du skriver ut ett formulär, som `{{ form }}` i en mall, från Django 5.0. För att göra det lättare att använda den nya utdatastilen kan standardformuläret och formulärmallarna nu konfigureras på projektnivå via inställningen [`FORM_RENDERER`](/sv/5.2/ref/settings/#std-setting-FORM_RENDERER). Se [formavsnittet (nedan)](#forms-4-1) för fullständig information. ### inställning `CSRF_COOKIE_MASKED` Den nya övergångsinställningen `CSRF_COOKIE_MASKED` gör det möjligt att ange om CSRF-cookien ska maskeras. [`CsrfViewMiddleware`](/sv/5.2/ref/middleware/#django.middleware.csrf.CsrfViewMiddleware) maskerar inte längre CSRF-cookien som den gör med CSRF-token i DOM. Om du uppgraderar flera instanser av samma projekt till Django 4.1 bör du ställa in `CSRF_COOKIE_MASKED` till `True` under övergången, för att möjliggöra kompatibilitet med de äldre versionerna av Django. När övergången till 4.1 är slutförd kan du sluta åsidosätta `CSRF_COOKIE_MASKED`. Denna inställning är föråldrad från och med den här utgåvan och kommer att tas bort i Django 5.0. ### Mindre funktioner #### [`django.contrib.admin`](/sv/5.2/ref/contrib/admin/#module-django.contrib.admin) - CSS-variablerna för admin [dark mode](/sv/5.2/ref/contrib/admin/#admin-theming) tillämpas nu i en separat stilmall och ett separat mallblock. - [ModelAdmin Lista Filter](/sv/5.2/ref/contrib/admin/filters/#modeladmin-list-filters) som tillhandahåller anpassade `FieldListFilter`-underklasser kan nu styra värdeseparatorn för frågesträngen när man filtrerar efter flera värden med hjälp av `__in`-uppslagningen. - Admin [`history view`](/sv/5.2/ref/contrib/admin/#django.contrib.admin.ModelAdmin.history_view) är nu paginerad. - Relaterade widgetomslag har nu en länk till objektets ändringsformulär. - Metoden [`AdminSite.get_app_list()`](/sv/5.2/ref/contrib/admin/#django.contrib.admin.AdminSite.get_app_list) gör det nu möjligt att ändra ordningen på appar och modeller på adminindexsidan. #### [`django.contrib.auth`](/sv/5.2/topics/auth/#module-django.contrib.auth) - Standardantalet iterationer för PBKDF2-lösenordshashen ökas från 320.000 till 390.000. - Metoden [`RemoteUserBackend.configure_user()`](/sv/5.2/ref/contrib/auth/#django.contrib.auth.backends.RemoteUserBackend.configure_user) gör det nu möjligt att synkronisera användarattribut med attribut i ett fjärrsystem, t.ex. en LDAP-katalog. #### [`django.contrib.gis`](/sv/5.2/ref/contrib/gis/#module-django.contrib.gis) - Den nya [`GEOSGeometry.make_valid()`](/sv/5.2/ref/contrib/gis/geos/#django.contrib.gis.geos.GEOSGeometry.make_valid)-metoden gör det möjligt att konvertera ogiltiga geometrier till giltiga. - Det nya argumentet `clone` för [`GEOSGeometry.normalize()`](/sv/5.2/ref/contrib/gis/geos/#django.contrib.gis.geos.GEOSGeometry.normalize) gör det möjligt att skapa en normaliserad klon av geometrin. #### [`django.contrib.postgres`](/sv/5.2/ref/contrib/postgres/#module-django.contrib.postgres) - Den nya [`BitXor()`](/sv/5.2/ref/contrib/postgres/aggregates/#django.contrib.postgres.aggregates.BitXor)-aggregatfunktionen returnerar ett `int` av det bitvisa `XOR` av alla icke-nullvärden. - [`SpGistIndex`](/sv/5.2/ref/contrib/postgres/indexes/#django.contrib.postgres.indexes.SpGistIndex) stöder nu täckande index på PostgreSQL 14+. - [`ExclusionConstraint`](/sv/5.2/ref/contrib/postgres/constraints/#django.contrib.postgres.constraints.ExclusionConstraint) stöder nu täckande uteslutningsbegränsningar med SP-GiST-index på PostgreSQL 14+. - Det nya attributet `default_bounds` för [`DateTimeRangeField`](/sv/5.2/ref/contrib/postgres/fields/#django.contrib.postgres.fields.DateTimeRangeField.default_bounds) och [`DecimalRangeField`](/sv/5.2/ref/contrib/postgres/fields/#django.contrib.postgres.fields.DecimalRangeField.default_bounds) gör det möjligt att ange gränser för list- och tuple-ingångar. - [`ExclusionConstraint`](/sv/5.2/ref/contrib/postgres/constraints/#django.contrib.postgres.constraints.ExclusionConstraint) tillåter nu att operatörsklasser anges med uttrycket [`OpClass()`](/sv/5.2/ref/contrib/postgres/indexes/#django.contrib.postgres.indexes.OpClass). #### [`django.contrib.sitemaps`](/sv/5.2/ref/contrib/sitemaps/#module-django.contrib.sitemaps) - Standardmallen för sitemap-index `` inkluderar nu tidsstämpeln `` där den är tillgänglig, genom den nya [`get_latest_lastmod()`](/sv/5.2/ref/contrib/sitemaps/#django.contrib.sitemaps.Sitemap.get_latest_lastmod)-metoden. Anpassade indexmallar för webbplatskartor bör uppdateras för den justerade [kontextvariabler](/sv/5.2/ref/contrib/sitemaps/#sitemap-index-context-variables). #### [`django.contrib.staticfiles`](/sv/5.2/ref/contrib/staticfiles/#module-django.contrib.staticfiles) - [`ManifestStaticFilesStorage`](/sv/5.2/ref/contrib/staticfiles/#django.contrib.staticfiles.storage.ManifestStaticFilesStorage) ersätter nu sökvägar till CSS-källkartreferenser med deras hashade motsvarigheter. #### Databas backends - Tredjeparts databasbackends kan nu ange den lägsta version som krävs av databasen med hjälp av attributet `DatabaseFeatures.minimum_database_version` som är en tupel (t.ex. `(10, 0)` betyder ”10.0”). Om en minsta version anges måste backends också implementera `DatabaseWrapper.get_database_version()`, som returnerar en tupel av den aktuella databasversionen. Backendets metod `DatabaseWrapper.init_connection_state()` måste anropa `super()` för att kontrollen ska kunna köras. #### Formulär - Den standardmall som används för att rendera formulär när de kastas till en sträng, t.ex. i mallar som `{{form }}`, kan nu konfigureras på projektnivå genom att ställa in [`form_template_name`](/sv/5.2/ref/forms/renderers/#django.forms.renderers.BaseRenderer.form_template_name) på den klass som tillhandahålls för [`FORM_RENDERER`](/sv/5.2/ref/settings/#std-setting-FORM_RENDERER). [`Form.template_name`](/sv/5.2/ref/forms/api/#django.forms.Form.template_name) är nu en egenskap som överförs till renderingsprogrammet, men kan åsidosättas med ett strängvärde för att ange mallnamnet per formulärklass. På samma sätt kan standardmallen som används för att rendera formulär specificeras via det matchande [`formset_template_name`](/sv/5.2/ref/forms/renderers/#django.forms.renderers.BaseRenderer.formset_template_name) renderer-attributet. - Den nya formulärmallen `div.html`, som refererar till attributet [`Form.template_name_div`](/sv/5.2/ref/forms/api/#django.forms.Form.template_name_div) och metoden [`Form.as_div()`](/sv/5.2/ref/forms/api/#django.forms.Form.as_div), renderar formulär med hjälp av HTML-elementen `
`. Denna nya utdatastil rekommenderas framför de befintliga stilarna [`as_table()`](/sv/5.2/ref/forms/api/#django.forms.Form.as_table), [`as_p()`](/sv/5.2/ref/forms/api/#django.forms.Form.as_p) och [`as_ul()`](/sv/5.2/ref/forms/api/#django.forms.Form.as_ul), eftersom mallen implementerar `
` och `` för att gruppera relaterade indata och är lättare att navigera i för skärmläsaranvändare. Den div-baserade utskriften kommer att bli standardrenderingsstilen från Django 5.0. - För att underlätta antagandet av den nya utdatastilen `
` finns två övergångsklasser för formulärrenderare tillgängliga: `django.forms.renderers.DjangoDivFormRenderer` och `django.forms.renderers.Jinja2DivFormRenderer`, för Django- respektive Jinja2-mallbackends. Du kan använda en av dessa via inställningen [`FORM_RENDERER`](/sv/5.2/ref/settings/#std-setting-FORM_RENDERER). Till exempel: ``` FORM_RENDERER = "django.forms.renderers.DjangoDivFormRenderer" ``` När utdatastilen `
` är standard, från Django 5.0, kommer dessa övergångsrenderare att avskrivas, för borttagning i Django 6.0. Deklarationen `FORM_RENDERER` kan tas bort vid den tidpunkten. - Om den nya utdatastilen `
` inte är lämplig för ditt projekt, bör du definiera en underklass för rendering som anger [`form_template_name`](/sv/5.2/ref/forms/renderers/#django.forms.renderers.BaseRenderer.form_template_name) och [`formset_template_name`](/sv/5.2/ref/forms/renderers/#django.forms.renderers.BaseRenderer.formset_template_name) för den önskade stilen och ange [`FORM_RENDERER`](/sv/5.2/ref/settings/#std-setting-FORM_RENDERER) i enlighet med detta. Till exempel, för utdatastilen `

` som används av [`as_p()`](/sv/5.2/ref/forms/api/#django.forms.Form.as_p), skulle du definiera en formulärrenderare som sätter `form_template_name` till `"django/forms/p.html"` och `formset_template_name` till `"django/forms/formsets/p.html"`. - Den nya [`legend_tag()`](/sv/5.2/ref/forms/api/#django.forms.BoundField.legend_tag) tillåter rendering av fältetiketter i `` taggar via det nya `tag` argumentet i [`label_tag()`](/sv/5.2/ref/forms/api/#django.forms.BoundField.label_tag). - Det nya argumentet `edit_only` för [`modelformset_factory()`](/sv/5.2/ref/forms/models/#django.forms.models.modelformset_factory) och [`inlineformset_factory()`](/sv/5.2/ref/forms/models/#django.forms.models.inlineformset_factory) gör det möjligt att förhindra att nya objekt skapas. - Klassattributen `js` och `css` för [Media](/sv/5.2/topics/forms/media/) tillåter nu användning av hashbara objekt, inte bara söksträngar, så länge som dessa objekt implementerar metoden `__html__()` (vanligtvis när de dekoreras med dekoratorn [`html_safe()`](/sv/5.2/ref/utils/#django.utils.html.html_safe)). - De nya attributen [`BoundField.use_fieldset`](/sv/5.2/ref/forms/api/#django.forms.BoundField.use_fieldset) och [`Widget.use_fieldset`](/sv/5.2/ref/forms/widgets/#django.forms.Widget.use_fieldset) hjälper till att identifiera widgets där indata ska grupperas i en `

` med en ``. - Argumentet [Felmeddelanden](/sv/5.2/topics/forms/formsets/#formsets-error-messages) för [`BaseFormSet`](/sv/5.2/topics/forms/formsets/#django.forms.formsets.BaseFormSet) gör det nu möjligt att anpassa felmeddelanden för ogiltigt antal formulär genom att skicka nycklarna `'too_few_forms'` och `'too_many_forms'`. - [`IntegerField`](/sv/5.2/ref/forms/fields/#django.forms.IntegerField), [`FloatField`](/sv/5.2/ref/forms/fields/#django.forms.FloatField) och [`DecimalField`](/sv/5.2/ref/forms/fields/#django.forms.DecimalField) accepterar nu valfritt ett `step_size`-argument. Detta används för att ställa in HTML-attributet `step` och valideras när formuläret skickas in. #### Internationalisering - Funktionen [`i18n_patterns()`](/sv/5.2/topics/i18n/translation/#django.conf.urls.i18n.i18n_patterns) stöder nu språk med både skript och regioner. #### Kommandon för hantering - [`makemigrations --no-input`](/sv/5.2/ref/django-admin/#cmdoption-makemigrations-noinput) loggar nu standardsvar och anledningar till varför migreringar inte kan skapas. - Det nya alternativet [`makemigrations --scriptable`](/sv/5.2/ref/django-admin/#cmdoption-makemigrations-scriptable) omdirigerar loggutdata och inmatningsfrågor till `stderr` och skriver endast sökvägar till genererade migreringsfiler till `stdout`. - Det nya alternativet [`migrate --prune`](/sv/5.2/ref/django-admin/#cmdoption-migrate-prune) gör det möjligt att ta bort icke-existerande migreringar från tabellen `django_migrations`. - Python-filer som skapats av [`startproject`](/sv/5.2/ref/django-admin/#django-admin-startproject), [`startapp`](/sv/5.2/ref/django-admin/#django-admin-startapp), [`optimizemigration`](/sv/5.2/ref/django-admin/#django-admin-optimizemigration), [`makemigrations`](/sv/5.2/ref/django-admin/#django-admin-makemigrations) och [`squashmigrations`](/sv/5.2/ref/django-admin/#django-admin-squashmigrations) formateras nu med kommandot `black` om det finns i din `PATH`. - Det nya kommandot [`optimizemigration`](/sv/5.2/ref/django-admin/#django-admin-optimizemigration) gör det möjligt att optimera åtgärder för en migrering. #### Migreringar - Den nya [`RenameIndex`](/sv/5.2/ref/migration-operations/#django.db.migrations.operations.RenameIndex)-operationen gör det möjligt att byta namn på index som definieras i [`Meta.indexes`](/sv/5.2/ref/models/options/#django.db.models.Options.indexes) eller `index_together`-alternativen. - Autodetektorn för migreringar genererar nu [`RenameIndex`](/sv/5.2/ref/migration-operations/#django.db.migrations.operations.RenameIndex)-operationer i stället för `RemoveIndex` och `AddIndex`, när man byter namn på index som definieras i [`Meta.indexes`](/sv/5.2/ref/models/options/#django.db.models.Options.indexes). - Migreringsautodetektorn genererar nu [`RenameIndex`](/sv/5.2/ref/migration-operations/#django.db.migrations.operations.RenameIndex)-operationer istället för `AlterIndexTogether` och `AddIndex`, när index som definieras i `Meta.index_together` flyttas till [`Meta.indexes`](/sv/5.2/ref/models/options/#django.db.models.Options.indexes). #### Modeller - Argumentet `order_by` i [`Window`](/sv/5.2/ref/models/expressions/#django.db.models.expressions.Window)-uttrycket accepterar nu strängreferenser till fält och transformationer. - Den nya inställningen [`CONN_HEALTH_CHECKS`](/sv/5.2/ref/settings/#std-setting-CONN_HEALTH_CHECKS) gör det möjligt att aktivera hälsokontroller för [persistent database connections](/sv/5.2/ref/databases/#persistent-database-connections) i syfte att minska antalet misslyckade förfrågningar, t.ex. efter omstart av databasservern. - [`QuerySet.bulk_create()`](/sv/5.2/ref/models/querysets/#django.db.models.query.QuerySet.bulk_create) stöder nu uppdatering av fält när en radinsättning misslyckas med unikhetsbegränsningar. Detta stöds på MariaDB, MySQL, PostgreSQL och SQLite 3.24+. - [`QuerySet.iterator()`](/sv/5.2/ref/models/querysets/#django.db.models.query.QuerySet.iterator) har nu stöd för prefetching av relaterade objekt så länge argumentet `chunk_size` anges. I äldre versioner gjordes ingen prefetching. - [`Q`](/sv/5.2/ref/models/querysets/#django.db.models.Q)-objekt och querysets kan nu kombineras med hjälp av `^` som operatorn exclusive or (`XOR`). `XOR` har inbyggt stöd i MariaDB och MySQL. För databaser som inte stöder `XOR` kommer frågan att konverteras till en motsvarighet med hjälp av `AND`, `OR` och `NOT`. - Det nya attributet [Field.non\_db\_attrs](/sv/5.2/howto/custom-model-fields/#custom-field-non-db-attrs) gör det möjligt att anpassa attribut för fält som inte påverkar en kolumndefinition. - På PostgreSQL skapas nu `AutoField`, `BigAutoField` och `SmallAutoField` som identitetskolumner snarare än seriella kolumner med sekvenser. #### Förfrågningar och svar - [`HttpResponse.set_cookie()`](/sv/5.2/ref/request-response/#django.http.HttpResponse.set_cookie) stöder nu [`timedelta`](https://docs.python.org/3/library/datetime.html#datetime.timedelta)-objekt för argumentet `max_age`. #### Säkerhet - Den nya inställningen [`SECRET_KEY_FALLBACKS`](/sv/5.2/ref/settings/#std-setting-SECRET_KEY_FALLBACKS) gör det möjligt att ange en lista med värden för rotation av hemliga nycklar. - Inställningen [`SECURE_PROXY_SSL_HEADER`](/sv/5.2/ref/settings/#std-setting-SECURE_PROXY_SSL_HEADER) stöder nu en kommaseparerad lista med protokoll i rubrikvärdet. #### Signaler - Signalerna [`pre_delete`](/sv/5.2/ref/signals/#django.db.models.signals.pre_delete) och [`post_delete`](/sv/5.2/ref/signals/#django.db.models.signals.post_delete) skickar nu ut raderingens `ursprung`. #### Mallar - HTML-elementets ```